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This manual describes the OS/VS - DOS/VSE - VM/370 assembler 
language. 

The OS/VS - VM/370 assembler language offers the following improvements 
over the OS/360 assembler language as processed by the F assembler: 

1. New instructions and functions 

2. Relaxation of language restrictions on character string lengths, 
attribute usage, SET symbol dimensions, and on the number of entries 
allowed in the External Symbol Dictionary 

3. New system variable symbols 

U. New options: for example, for the printing of statements in the 
program listings or for the alignment of constants and areas. 

The figure on the following pages lists in detail these assembler 
language improvements and indicates the sections in the manual where the 
instructions and functions incorporating these improvements are 
described. If you are already familiar with the OS/360 assembler 
language as processed by the F assembler, you need only read those 
sections. Also included in the figure on the following pages are the 
improvements of the DOS/VS assembler language over the DOS/360 assembler 
language as processed by the D assembler. 

NOTE: Sections I through L, describing the macro facility and the 
conditional assembly language, have been expanded to include more 
examples and detailed descriptions. 

Note for VM/370 Users 

The services provided by the OS Linkage Editor and Loader programs are 
paralleled in VM/370 by those provided by the CMS Loader. Therefore, 
for any reference in this publication to those OS programs, you may 
assume that the CMS Loader performs the same function. 

Certain shaded notes in this publication refer to "OS only" information. 
Where you see these notes you may assume the information also applies 
for VM/370 users. 

Note for DOS/VSE Use rs 

All references to DOS and DOS/VS are also applicable to DOS/VSE. 
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COMPARISON OF ASSEMBLERS 








Language Feature 


Assemblers 


Described in 


DOS/360 (D) 


DOS/VSE 


OS/360 (F) 


, OS/VS- 
VM/370 


1. 


No of continuation lines allowed in 
one statement 


1 


2 


2 


2 


B1B 


2. 


Location Counter value printed for 
EQU, USING, ORG (in ADDR2 field) 


3 bytes 


3 bytes 


3 bytes 


4 bytes 
(up to 3 
leading zeros 
suppressed) 


C4B 


3. 


Self-Defining Terms 
maximum value: 


2 24 -1 


2 24 -1 


2 24 -1 


2 31 -1 


C4E 




number of digits 

binary: 

decimal: 

hexadecimal: 

character: 


24 
8 
6 
3 


24 
8 
6 
3 


24 
8 
6 
3 


32 
10 
8 
4 




4. 


Relocatable and Absolute Expressions 
unary operators allowed: 
value carried: 

number of operators: 
levels of parentheses: 


no 

truncated to 
24 bits 
15 
5 


yes 

truncated to 
24 bits 
15 
5 


no 

truncated to 
24 bits 
15 
5 


yes 
31 bits 

19 
6 


C6B 


5. 


Alignment of Constants 

(with no length modifier) when 

NOALIGN option specified: 


ALIGN/ 
NOALIGN 
option not 
allowed 


constants 
not aligned 


constants 
aligned 


constants 
not aligned 


D2 


6. 


Extended Branching Mnemonics 
for RR format instructions: 


no 


yes 


no 


yes 


D1H 


7. 


COPY Instruction 
nesting depth allowed: 
macro definitions copied: 


none 
no 


3 

yes 


none 
no 


5 

yes 


E1A 


8. 


END Instruction 














generated or copied END 
instructions: 


no 


no 


no 


yes 


El 


9. 


All control sections initiated by a 
CSECT start at location in listing 
and object deck 


no 


yes 


no 


no 


E2C 


10. 


External Symbol Dictionary Entries 
maximum allowed: 


255 


511 


255 


399 

(including 
entry symbols 
identified by 
ENTRY) 


E2G 


11. 


DSECT Instruction blank name entry: 


no 


yes 


no 


yes 


E3C 


12. 


DROP Instruction 
blank operand entry: 


not allowed 


signifies all 
current base 
registers 
dropped 


not allowed 


signifies all 
current base 
registers 
dropped 


F1B 


13. 


EQU Instruction 

second operand as length attribute: 
third operand as type attribute: 


no 
no 


no 
no 


no 
no 


yes 
yes 


G2A 


14. 


DC/DS Instruction; 
number of operands: 


one 


multiple 


multiple 


multiple 


G3B 
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Language Feature 



Assemblers 



DOS/360 (D) 



DOS/VSE 



OS/360 (F) 



OS/VS- 
VM/370 



Described in 



15. Bit-length specification allowed: 



16. Literal Constants 

multiterm expression for 
duplication factor: 
length, scale, and 
exponent modifier: 
Q- or S-type address constant: 

17. Binary and Hexadecimal Constants 
number of nominal values: 

18. Q-type address constant allowed: 

19. ORG Instruction 
name entry allowed: 

20. Literal cross-reference: 

21. CNOP Instruction 
symbol as name entry: 

22. PRINT Instruction 
inside macro definition: 

23. TITLE Instruction 
number of characters in name 
(if not a sequence symbol): 

24. OPSYN Instruction: 

25. PUSH and POP Instructions 

for saving PRINT and USING status: 

26. Symbolic Parameters and 
Macro Instruction Operands 

maximum number: 



mixing positional and keyword: 



27. Generated op-codes START, CSECT, 
DSECT, COM allowed 

28. Generated Remarks due to generated 
blanks in operand field: 

29. MNOTE Instruction 
in open code: 

30. System Variable Symbols 

&SYSPARM: 
&SYSDATE: 
&SYSTIME: 

31. Maximum number of characters in 
macro instruction operand: 

32. Type and Count Attribute of 

SET symbols: 
&SYSPARM, &SYSNDX, 
&SYSECT. &SYSDATE, &SYSTIME: 



no 
no 



one 
no 



sequence symbol 
or blank 



sequence symbol 
or blank 



100 



all positional 
parameters 
or operands 
must come 
first 



yes 
no 
no 



127 

no 
no 



yes 



yes 



yes 
no 



one 

no 

sequence symbol 
or blank 

yes 

sequence symbol 
or blank 



yes 



4 
no 



200 



all positional 
parameters 
or operands 
must come 
first 



yes 



yes 
no 
no 



255 

no 
no 



yes 



no 
no 



one 
yes 



sequence symbol 
or blank 



only sequence 
symbol or blank 



4 

yes 

no 
200 



all positional 
parameters 
or operands 
must come 
first 



no 
no 
no 



255 

no 
no 



yes 



yes 



yes 
yes 



multiple 

yes 

any symbol 
or blank 

yes 

any symbol 
or blank 

yes 



8 
yes 

yes 



no fixed 
maximum 

keyword param- 
eters or operands 
can be inter- 
spersed among 
positional param 
eters or operands 



yes 



yes 



yes 



yes 
yes 
yes 



255 

yes 
yes 



G3B 



G3C 



G3D 
G3F 

G3M 

H1A 

H1B 
H1C 

H3A 
H3B 

H5A 
H6 



J2C 
K1B 



J3C 
K3C 



J4B 



J4B 



J5D 



J7 



K5 



L1B 





COMPARISON OF ASSEMBLERS 








Language Feature 


Assemblers 


Described in 


DOS/360 (D) 


DOS/VSE 


OS/360 (F) 


OS/VS - 
VM/370 


33. 


SET Symbol Declaration 










L2 




global and local mixed: 


no, global must 
precede local 


no, global must 
precede local 


no, global must 
precede local 


yes 






global and local must immedi- 














ately follow prototype state- 














ment, if in macro definition: 


yes 


yes 


yes 


no 






must immediately follow any source 














macro definitions, if in open code: 


yes 


yes 


yes 


no 




34. 


Subscripted SET Symbols 










L2 




maximum dimension: 


255 


4095 


2500 


32,767 




35. 


SETC Instruction 










L3B 




duplication factor in operand: 


no 


no 


no 


yes 






maximum number of characters 














assigned 


8 


255 


8 


255 




36. 


Arithmetic Expressions 
in conditional assembly 










L4A 




unary operators allowed: 


no 


yes 


no 


yes 






number of terms: 


16 


16 


16 


up to 25 






levels of parentheses: 


5 


5 


5 


up to 1 1 




37. 


ACTR Instruction allowed anywhere 
in open code and inside macro 
definitions: 


no, only immedi- 
ately after global 
and local SET 
symbol 
declarations 


yes 


no, only immedi- 
ately after global 
and local SET 
symbol 
declarations 


yes 


L6C 


38. 


Options for Assembler Program 














ALIGN 


no 


yes 


yes 


yes 


D2 




ALOGIC 


no 


no 


no 


yes 


L8 




MCALL 


no 


no 


no 


yes 


J8B 




EDECK 


no 


yes 


no 


no 


Order No. 
GC33-4024 




MLOGIC 


no 


no 


no 


yes 


L8 




LIBMAC 


no 


no 


no 


yes 


J8A 
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This is a reference manual for the OS/VS - DOS/VSE - VM/370 assembler 
language. It will enable you to answer specific questions about 
language functions and specifications. In many cases it also provides 
information about the purpose of the instruction you refer to, as well 
as examples of its use. 

The manual is not intended as a text for learning the assembler language. 
Who This Manual Is For 



This manual is for programmers coding in the OS/VS - VM/370 or DOS/VSE 
assembler language. 



Major Topics 



^#™«\ 



This manual is divided into four main parts (aside from the 
"Introduction" and the Appendixes) : 

PART I (Sections B and C) describes the coding rules for, and the 

structure of, the assembler language. 

PART II (Section D) describes the machine instruction types and their 

formats. 

PART III (Sections E through H) describes the assembler instructions. 

PART IV (Sections I through L) describes the macro facility and the 

conditional assembly language. 



How To Use This Manual 

Since this is a reference manual, you should use the Index or the Table 
of Contents to find the subject you are interested in. 

Complete specifications are given for each instruction or feature of the 
assembler language (except for the machine instructions, which are 

documented in Principles of Operation — see "References You May Need") . 
In many cases, a "Purpose" section suggests why you might use the 
feature; a "Specifications" section explains use of a complex feature; 
and one or more figures give examples of coding an instruction. 

If you are a present user of the OS Assembler F or the DOS Assembler D, 
you need only read those sections listed in the table preceding this 
"Preface" which indicates those language features that are different 
from the DOS or OS System/360 languages. 
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TABS : Tabs mark the beginning of the specifications portion of the 
language descriptions* Use the tabs for quick referencing. 






Tab 



USING 



OS- DOS DIFFERENCES ; Wherever the OS/VS and DOS/VS assembler languages 
differ, the specifications that apply only to one assembler or the other 
are so marked. The 'OS only* markings also apply for the VM/370 
assembler. 

OS only 

KEYS : The majority of figures are placed to the right of the text that 
describes them. Numbered keys within a figure are duplicated to the 
left of the text describing the figure. Use the numbered keys to tie 
the underlined passages in the text to specific parts of the figure. 

Key- Q 

GLOSSARY : The glossary at the back of the manual contains terms that 
apply to assembler programming specifically and to allied terms in data 
processing in general. You can use the Glossary for terms that are 
unfamiliar to you. 

IBM is grateful to the American National Standards Institute (ANSI) for 
permission to reprint its definitions from the American National 

Standard Vocabulary for Information Processing, which was prepared by r"" 

Subcommittee X3.5 on Terminology and Glossary of American National v^ 

Standards Committee X3. 



References You May Need 

You may want to refer to 

IBM System/370 Principles of Operation , GA22-7000, or IBM 4300 
Processors Principles of Operation for ECPS:VSE Mode , GA22-7070, the 
definitive publications for machine instructions, and to 

QS/VS - VM/370 Assembler Programmer's Guide , GC33-4021 

for detailed information about the OS/VS - VM/370 Assembler. 

Guide to the DOS/VSE Assembler , GC33-4024 

for detailed information about the DOS/VSE Assembler. 
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Section A: Introduction 



What the Assembler Does 



A computer can understand and interpret only machine 
language. Machine language is in binary form and, thus, 
very difficult to write. The assembler language is a 
symbolic programming language that ypu can use to code 
instructions instead of coding in machine language. 

Because the assembler language allows you to use meaningful 
symbols made up of alphabetic and numeric characters instead 
of just the binary digits and 1 used in the machine 
language, you can make your coding easier to read, 
understand, and change. 



The assembler must translate the symbolic assembler language 
into machine language before the computer can execute ycur 
program, as shown in the figure below. 
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Assume that your program, written in the assembler language, 
has been punched into a deck of cards called the scurce 
deck. This deck, also known as a source module, is the 
input to the assembler. (You can also enter a source 
module as input to the assembler through a terminal.) 



The assembler processes your source module and produces 
an object module in machine language (called object cede) . 
Assume that the assembler punches this object module into 
a deck of cards called the object deck. 

The object deck or object module can be used as input to 
be processed by another processing program, called the 
linkage editor. Ihe linkage editor produces a load module 
that can be loaded later into the main storage of the 
computer, which then executes the program. Your source 
module and the object code produced is printed, alcng with 
other information on a program listing. 



Al - The Assembler Language 



The assembler language is the symbolic programming language 
that lies closest to the machine language in form and 
content. You will, therefore, find the assembler language 
useful when: 

• You need to control your program closely, down to the 
byte and even bit level or 

• You must write subroutines for functions that are not 
provided by other symbolic programming languages such as: 
ALGOL, COBOL, FORTRAN, or PL/1. 

The assembler language is made up of statements that 
represent instructions or comments. The instruction 
statements are the working part of the language and are 
divided into the following three groups: 

1 . Machine instructions 

2. Assembler instructions 

3. Macro instructions. 



Machine Instructions 



A machine instruction is the symbolic representation of 
a machine language instruction of the IBM Systeir/370 
instruction set. It is called a machine instruction because 
the assembler translates it into the machine language cede 
which the computer can execute. Machine instructions are 
described in PART II; SECTION £ of this manual. 



Assembler Instructions 



An assembler instruction is a request to the assembler 
program to perform certain operations during the assembly 
of a source module, for example, defining data constants, 
defining the end of the source module, and reserving storage 
areas. Except for the instructions that define constants, 
the assembler does not translate assembler instructions 
into object code. The assembler instructions are described 
in PART III; SECTIONS E, F, G, and H and PART IV; SECTIONS 
J, K, and L of this manual. 



Macro Instructions 



A macro instruction is a request to the assembler program 
to process a predefined sequence of code called a iracrc 
definition. From this definition, the assembler generates 
machine and assembler instructions which it then processes 
as if they were part of the original input in the source 
module . 

IBM supplies macro definitions for input/output, data 
management, and supervisor operations that you can call 
for processing by coding the required macro instructiDn. 
(These IBM-supplied macro instructions are not described 
in this manual.) 

You can also prepare your own macro definitions and call 
them by coding the corresponding macro instructions. This 
macro facility is introduced in PART IV; SECTION I. A 
complete description of the macro facility, including the 
macro definition, the macro instruction and the conditional 
assembly language, is given in PART IV; SECTIONS J, K, and 
L. 






A2 - The Assembler Program 



The assembler program, also referred to as the "assembler", 
processes the machine, assembler, and macro instructions 
you have coded in the assembler language and produces an 
object module in machine .language. 
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A2A - ASSEMBLER PROCESSING SEQUENCE 

The assembler processes the three types of assembler 
language instructions at different times during its 
processing sequence. You should be aware of the assembler's 
processing sequence in order to code your program correctly, 
The figure below relates the assembler processing sequence 
to the other times at which your program is processed and 
executed. 
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The assembler processes most instructions on two occasions; 
dfc first at pre-assembly time and later at assembly time . ^fr 
^^ However, it does some processing, for example, macro ^^ 

processing, only at pre-assembly time. 

The assembler also produces information for other 
-^ processors. The linkage editor uses such information at 
^9 linkage-edit time to combine object modules into load 
modules. The loader loads your program (combined load 

O modules) into virtual storage (see GLOSSARY) at program 
fetch time . Finally, at execution time , the computer ^S 
executes the object code produced by the assembler at 
assembly time. 



V 



Machine Instruction Processing 



The assembler processes all machine instructions and 
translates them into object code at assembly time, as shewn 
in the figure below. 
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Assembler instructions are divided into two main types 

1. Ordinary assembler instructions 

2. Conditional assembly instructions and the macro 
processing instructions (MACRO, MENE, MEXIT and MNOuEJ 
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The assembler processes ordinary assembler instructions 
at asseirbly time, as shown in the figure below. 
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NOTES : 

1. The assembler evaluates absolute and relocatable 
expressions at assembly time; they are sometimes called 
assembly time expressions. 

2. Some instructions produce output for processing after 
assembly tirre. 
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The assembler processes conditional assembly instructions 
and macro processing instructions at pre -assembly time , 
as shown in the figure below. 
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1. The assembler evaluates the conditional assembly 
expressions (arithmetic, logical, and character) at pre- 
assembly time. 

2. The assembler processes the machine and assembler 
instructions generated from pre-assembly processing at 
assembly time. 
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Macro Instruction Processing 



The assembler processes macro instructions at pre -assembly 
time, as shown in the figure below. 
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NOTE: The assembler processes the machine and ordinary 
assembler instructions generated from a macro definition 
called by a macro instruction at assembly ti^ire. 



The assembler prints in a program listing all the 
information it produces at the various processing times 
described in the above figures. 



A3 - Relationship of Assembler to Operating System 



The assembler is a programming component of the OS/VS, 
VM/370, or DOS/VS. These system control programs provide 
the assembler with the services: 



r«y 



• For assembling a source module and 

• For running the assembled object module as a prograir. 

In writing a source module you must include instructions 
that request the desired service functions from the 
operating system. 

Services Provided by the Operating System 

OS/VS and DOS/VS provide the following services: 

1. For assembling the source module: 

a. A control program 

b. Libraries tc contain source code and macro 
definitions 

c. Utilities 

2. For preparing for the execution of the assembler program 
as represented by the object module: 

a. A control program 

b. Storage allocation 

c. Input and output facilities 

d. A linkage editor 

e. A loader. 

VM/370 provides the following services: 



1. For assembling the source module: 

a. An interactive control program 

b. Files to contain source code and macro definitions 

c. Utilities. 

2. For preparing for the execution of the assembler programs 
as represented by the object modules: 

a. An interactive control program 

b. Storage allocation 

c. Input and output facilities 

d. The CMS Loader. 
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A4 - Coding Aids M 



It can be very difficult to write an assembler language 
program using only machine instructions. The assembler 
provides additional functions that make this task easier. 
They are summarized belcw. 



Symbolic Representation of Program Elements 



Symbols greatly reduce programming effort and errors. 
You can define symbols to represent storage addresses, 
displacements, constants, registers, and almost any element 
that makes up the assembler language. These elements 
include operands, operand subfields, terras, and expressions. 
Symbols are easier to rememfcer and code than numbers; 
moreover, they are listed in a symbol cross-reference table 
which is printed in the program listings. Thus, you can 
easily find a symbol when searching for an error in your 
code. 



Variety of Cata Representation 

You can use decimal, binary, hexadecimal or character 

representation which the assembler will convert for you y 

into the binary values required by the machine language. 



Controlling Address Assignment 

If you code the appropriate assembler instruction, the 
assembler will compute the displacement from a base address 
of any symbolic addresses you specify in a machine 
instruction. It will insert this displacement, along with 
the base register assigned by the assembler instruction, 
into the object code of the machine instruction. 

At execution time, the object code of address references 
must be in the base-displacement form. The computer obtains 
the required address by adding the displacement to the 
base address contained in the base register. 
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Belocatability 

The assembler produces an object module that can be 
relocated froir an originally assigned storage area to any 
other suitable virtual storage area without affecting 
program execution. This is made easier because most 
addresses are assembled in their base- displacement forir. 



Segmenting a Program 

You can divide a source module into one or more control 
sections. After assembly, you can include or delete 
individual control sections from the resulting object 
module before you load it for execution. Control sections 
can be loaded separately into storage areas that are not 
contiguous . 



Linkage Between Source Modules 

You can create symbolic linkages between separately 
assembled source modules. This allows you to refer 
symbolically from one source module to data defined in 
another source module. You can also use symbolic addresses 
to branch between modules. 



Program Listings 

The assembler produces a listing of your source module, 
including any generated statements, and the object code 
assembled from the source module. You can control the 
form and content of the listing to a certain extent. She 
assembler also prints messages about actual errors and 
warnings about potential errors in your source module. 
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Part I: Coding and Structure 



SECTION B: CODING CONVENTIONS 

SECTION C: ASSEMBLER LANGUAGE STRUCTURE 
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Section B: Coding Conventions 



This section describes the coding conventions that you must 
follow in writing assembler language programs. Assembler 
language statements are usually written on a coding form 
before they are punched onto cards, or entered as source 
statements through other forms of input (for example, 
through terminals or directly onto tape) . 



Standard Assembler Ceding Form 



You can write assembler language statements on the standard 
coding form (Order No. GX28-6509) shown below. She eclumns 
on this fcrir correspond to the columns on a punched card 
or positions on a source statement entered through a 
terminal. The form has space for program identification 
and instructions to keypunch operators. 
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• A tt»nd»rd emrd farm, IBM glKtro 6509. is available for punching source statements from this form. 
Instructions for using this form are in any IBM System/360 Assembler Reference Manual. 
Address comments concerning this form to IBM Nordic Laboratory, Publications Development. 
Box 962 S 181 09 Lidingo 9, Sweden. 



%^JP 



Section B: Coding Conventions .15 



Bl - Coding Specifications 



B1A - FIELD BOUNDARIES 



o 

e 
© 



Assembler language statement usually occupy one 80-column 
line on the standard form (for statements occupying more 
than 80 columns, see B1B below). Note that any printable 
character punched into any column of a card, or otherwise 
entered as a position in a source statement, is reproduced 
in the listing printed by the assembler. All characters 
are placed in the line by the assembler. Whether they are 
printed or not depends on the printer. Each line of 
the coding form is divided into three main fields: 

The Statement field , 

The Identification -Sequence field , and 

The Continuation Indicator field. 



Stmnt Field 



The Statement Field 

The instructions and comments statements must be written 
in the statement field. The statement field starts in 
the "begin" column and ends in the "end" column. Any 
continuation lines needed must start in the "continue" 
column and end in the "end" column. The assembler assumes 
the following standard values for these columns: 

Jfc • The "begin" column is column 1 

A • The "end" column is column 71, and 

wk • The "continue" column is column 16. 

These standard values can be changed by using the ICTL 
instruction. However, all references to the "begin", 
"end", and "continue" columns in this manual refer to the 
standard value described above. 
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The Identification - Sequence Field 



The identification-sequence field can contain identification 
characters or sequence numbers or both. If the ISEQ 
instruction has been specified to check this field, the 
assembler will verify whether or not the source statements 
are in the correct sequence. 

NOTE: The field the assembler normally checks lies in 
columns 73 through 80. However, if the ICTL instruction 
has been used to change the begin and end columns, the 
boundaries for the identification- sequence field can be 
affected. 



The Continuation Indicator Field 



The continuation indicator field occupies the column after 
the end column. Therefore, the standard position for this 
field is column 72. A non-blank character in this column 
indicates that the current statement is continued on the 
next line. This column must be blank if a statement is 
completed on the same line; otherwise the assembler will 
treat the statement that follows on the next line as a 
continuation line of the current statement. 



Field Positions 



The statement field always lies between the begin and the 
end columns. The continuation indicator field always lies 
in the column after the end column. The identification- 
sequence field usually lies in the field after the 
continuation indicator field. However, the ICTL 
instruction, by changing the standard begin, end, and 
continue columns can create a field before the begin column, 
This field can then contain the identification- sequence 
field. 
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B1B - CONTINUATION LINES 



To continue a statement on another line, the following 
applies: 

1 . Enter a non-blank character in the continuation indicator 
field (column 72) . This non -blank character must not be 
part of the statement coding. When more than one 
continuation line is needed, a non -blank character must 

be entered in column 72 of each line that is to be 
continued. 

2. Continue the statement on the next line, starting in 
the continue column (column 16) . Columns to the left of 
the continue column must be blank. Comments may be 
continued after column 16. 

Note that if an operand is continued after column 16 it 
is taken to be a comment. Also if the continuation 
indicator field is filled in on one line and the user 
tries to start a totally new statement after column 16 on 
the next line, this statement will be taken as a comment 
belonging to the previous statement. 

Only two continuation lines are allowed for a single 
assembler language statement. However, macro instruction 
statements and the prototype statement of macro definitions 
can have as many continuation lines as needed. 
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B1C - COMMENTS STATEMENT FORMAT 



o 



Comments statements are not assembled as part of the object 
module, but are only printed in the assembly listing. 
As many comments statements as needed can be written, 
subject to the following rules: 

1. Comments statements require an asterisk in the begin 
column. 



Comments 



NOTE: Internal macro definition comments statements require 
a period in the begin column, followed by an asterisk (for 
details see J6A) . 

2. Any characters, including blanks and special characters, 
of the IBM System/370 Character Set (see C3) can be used. 

3. Comments statements must lie in the statement field 
and not run over into the continuation indicator field ; 
otherwise the statement following the comments statement 
will be considered as a continuation line of that corrnents 
statement. 



4. Comments statements must not appear between an 
instruction statement and its continuation lines. 
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BID — INSTRUCTION STATEMENT FOIWAT 

The statement field of an instruction statement must be 
foriratted tc include frcm one to four of the following 
entries: 

1. A naire entry 

2. An operaticn entry 

3. An operand entry 

4. A rerrarks entry. 

Fixed Fcrirat 



Instructions 



The standard coding fern; is divided into fields that provide 
fixed positions for the first three entries, as fcllcvts: 
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^p An 8-character name field starting in ecluirn 1 . 

^h A 5-character operaticn field starting in ecluirn 10. 

^M An operand field that begins in column 16. 

ONote that with this fixed format one blank separates each 
field. 



Free Format 



It is not necessary to code the name, operation, and cperand 
entries according tc the fixed fields on the standard 
coding form. Instead, these entries can be written in 
any position, subject tc the formatting specifications 
below. 



Vv 
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Formatting Specifications 



Whether using fixed or free format, the following general 
rules apply to the coding of an instruction statement: 

1. The entries must be written in the following order: 
name, operation, operand, and remarks. 

2. The entries must be contained in the begin column (1) 
through the end column (71) of the first line and, if 
needed, in the continue column (16) through the end ccluirn 

(71) of any continuation lines. 

3. The entries must be separated from each other by one 
or more blanks . 

^p U. If used, the name entry must start in the begin column . 

05. The name and operation entries , each followed by at 
least one blank, must be contained in the first line cf 
an instruction statement. 

6. The operation entry must start at least one column to 
the right of the begin column. 
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THE NAME ENTRY : The name entry identifies an instruction 
statement. 



The following applies to the name entry: 

1. It is usually optional. 

2. It must be a valid symbol at assembly time (after 
substitution for variable symbols, if specified) ; for an 
exception see the TITLE instruction (H3E) . 
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THE OPERATION ENTRY ; The operation entry provides the W .J 

symbolic operation code that specifies the machine, 
assembler, or macro instruction to be processed. The 
following applies to the operation entry: 

1. It is mandatory. 

2. For machine and assembler instructions it must be a 
valid symbol at assembly time (after substitution for 
variable symbols, if specified) . The standard symbolic 
operation codes are five characters or less (see Appendixes 
IV and V) . 

flfc'-HOTIr The standard set of codes can be changed by QPl 
^instructions (as described in HSJ-«\.,- .--. Bfrf^f 

3. For macro instructions it can be any valid symbol that 
is not identical to the operation codes described in 2 
above. 

THE OFERAND ENTRY : The operand entry has one or more 
operands that identify and describe the data used by an 
instruction. The following applies to operands: 

1. One or more operands are usually required, depending 
on the instruction. 

2. Operands must be separated by commas. No blanks are 
allowed between the operands and the commas that separate 
them. 

3. Operands must net contain embedded blanks, because a (^ 
blank normally indicates the end of the operand entry. V^ 
However, blanks are allowed if they are included in 

character strings enclosed in apostrophes (for example, 
C*J N*) or in logical expressions (see L4C) . 
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THE REMA RKS ENTRY i The reirarks entry is used tc describe 
the current instruction . The following applies to the 
remarks entry: 

1. It is optional. 

2. It can contain any of the 256 characters (or punch 
combinations) of the IEW Systeir/370 character set, including 
blanks and special characters. 

^p 3. it can follow any operand entry . 

4. If ah optional operand entry is omitted, reirarks are 
allowed if the absence of the operand entry is indicated 
by a comma, preceded and followed by one or ircre blanks. 
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Section C: Assembler Language Structure 



This section describes the structure of the assembler 
language, that is, the various statements which are allowed 
in the language and the elements that make up those 
statements . 
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CI -- The Source Module <p) 



A source module is a sequence of assembler language 
statements that constitute the input to the assembler. 
The figure on the opposite Fage shows an overall picture 
of the structure of the assembler language. 



C2 - Instruction Statements 

The instruction statements of a source module are composed 
of one to four entries that are contained in the statement 
field. Other entries outside the statement field are 
discussed in B1A. The four statement entries are: 

1. A name entry (usually optional) 

2. An operation entry (mandatory) 

3. An operand entry (usually required) 

4. A remarks entry (optional) . 

NOTES: 

1. The figures in this subsection show the overall structure 

of the statements that represent the assembler language ~, 

instructions and are not specifications for these 

instructions. The individual instructions, their purposes, \s' 

and their specifications are described in other sections of 

this manual (as cross-referenced in the figures) . Nodel 

statements, used to generate assembler language statements, 

are described in J4 . 

2. The remarks entry is not processed by the assembler, but 
only copied into the listings of the program. It is 
therefore not shown except in the overview opposite. 
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EITHER 



MACHINE 
Instructions 



^""V 



NAME 






Source Module 
made up of 
Source Statements 



Source Statements are 






INSTRUCTION 
STATEMENTS 



nm 



>Gft OR 



Which are of three 
main types 




ASSEMBLER 
Instructions 



MACRO 
Instructions 



Which are composed of 
one to four entries 



OPERATION 



OPERAND 



Which ,for machine instruc- 
tions, is composed of 



EXPRESSIONS 



Which are composed of 



TERMS 



Combination 
of terms 



Which are composed of characters 



IBM SYSTEM/370 
CHARACTER SET 



COMMENTS 
STATEMENTS 



REMARKS 



{ Which are composed of 



CHARACTER 
STRINGS 
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C2A — MACHINE INSTRUCTIONS 

The machine instruction statements are described in the 
figure below. 

The instructions themselves are discussed in Part II cf 
this manual and summarized in Appendix IV. 




OPERATION 
Entry 




must be 



can be 



A symbolic 

Operation 

Code 



One or more 
operands 
composed of 




Exp (Exp) 



Exp(Exp,Exp) 

or 
Exp (,Exp) 



Arithmetic 
combination 
of terms 



Which can be 
any of the 
following 




Location 
Counter 
Reference 
e.g. * 




Symbol 
Length 
Attribute 
Reference 
e.g. L'HERE 



- 



Decimal 
e.g. 9 



Hexadecimal 
e.g. X 'D9' 



Binary 
e.g. B '1001' 




Exp = Expression 



A 

Self-Defining 

Term 



Which can be 
any of the 
following 



Character 
e.g. C 'JAN' 
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C2B — ASSEMBLER INSTRUCTIONS (f^ 4 

_____ _______ ^j 

The assembler instruction statements can be divided into 
two main groups: ordinary assembler instructions and 
conditional assembly instructions. 



Ordinary Assembler Instructions 

Ordinary assembler instruction statements are described 
in the figure on the opposite page. 

These instructions are discussed in Part III of this manual 
and summarized in Appendix V. 
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OPERATION 
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the format 
below 



'Decimal 
number' 

e.g. F'2' 



(Expression) 
e.g. A(ADDR) 



'Character 
string' 

e.g. C'A is B' 



Discussed more fully where individual instructions are described 
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Conditional Assembly Instructions 






Conditional assembly instruction statements and the iracrc 
processing statements (MACRO, MEND, MEXIT, MNOTE) are 
described in the figure below. 

The conditional assembly instructions are discussed in 
Section L and macro processing instructions in Section 
J; both types are summarized in Appendix V. 
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C2C — MACPC INSTRUCTIONS 



Macro instruction statements are described in the figure 
below; the prototype statement of a macro definition, which 
serves as a model for the macro instruction statement, 
is also shown. 

Macro instruction statements are discussed in Section K 
of this manual and the prototype statement is discussed 
in Section J2. 
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C3 - Character Set (f\ 

Terms, expressions, and character strings used to build 
source statements are written with the following characters: 

1. Alphameric Characters 

Alphabetic characters (or letters) : A through Z, and 

Digits (or numerals) : through 9 

2. Special characters 

♦-#-•*<)'/* blank 

Examples, showing the use of the above characters are given 
in the figure below. 

Normally, ycu would use strings of alphameric characters 
to represent data (terms, see C4) , and special characters 
as: 

a. Arithmetic operators in expressions 

b. Data or field delimiters 

c. Indicators to the assembler for specific handling. 

Characters are represented by the card-punch ccnrbinaticns 

and internal bit ccnf igurations listed in Appendix I. 

In addition to the printable characters listed abcve, any /^\ 

of the 256 combinations for punched cards listed in Appendix l \^ 

I can be used: 

1. Between paired apostrophes 

2. As statement remarks 

3. In comments statements 

M. In macrc instruction operands (for restrictions see 
K5) . 



34 



Page of GC33-4010-4 
Revised Feb. 25, 1975 
By TNL: GN33-8193 














Char. Set 


Characters 


Usage 


Example C« 


instituting 


Alphameric 


In symbols 


LABEL NINE #01 


Terms 


Digits 


As decimal 

self-defining 

terms 


01 9 


Terms 


Special 








Characters 


As Operators 






+ 


Addition 


NINE+FIVE^ 






- 


Subtraction 


NINE- 5 






* 


Multiplication 


9*FIVE 


► 


Expressions 


/ 


Division 


TEN/ 3 






+ or - 


(Unary) 


+NINE -FIVE 


Terms 




As Delimiters 






Blanks 


Between fields 


LABEL AR 3,4 


Statement 


Comma 


Between operands 


OPNDl,OPND2 


Operand field 


Apostrophes 


Enclosing 
character strings 


C STRING 1 


String 


Parentheses 


Enclosing subfields 
or subexpressions 


MOVE MVC TO (80), FROM 
(A+B*(C-D)) 


Statement 
Expression 




As indicators 








for 






Ampersand 


Variable symbol 


&VAR 


Term 


Period 


Sequence symbol 


.SEQ 


(label) 




Comments statement 
in Macro definition 


•*THIS IS A COMMENT 


Statement 




Concatenation 


&VAR.A 


Term 




Bit-length 


DC CL.7'AB' 


Operand 




specification 








Decimal point 


DC F'1.7E4' 


Operand 


Asterisk 


Location counter 
reference 


*+72 


Expression 




Comments statement 


* THIS IS A COMMENT 


Statement 


Equal sign 


Literal reference 


L 6,=F'2' 


Statement 




Keyword 


&KEY=D 


Keyword 
Parameter 
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C4 - Terms 



A term is the smallest element of 
the assembler language that 
represents a distinct and separate 
value. It can therefore be used 
alone or in combination with other 
terms to form expressions. Terms 
have absolute or relocatable values 
that are assigned by the assembler 
or are inherent in the terms 
themselves. 

A term is absolute if its value 
does not change upon program 
relocation and is relocatable if 
its value changes upon relocation. 
The various types of terms described 
below are summarized in the figure 
to the right. 









Terms 


Terms 


Term Can Be 


Value Is 


Absolute 


Relocatable 


Assigned by 
Assembler 


Inherent in 
"•"erm 


Symbols 


X 


X 


X 




Location 
Counter 
Reference 




X 


X 




Symbol 
Length 
Attribute 


X 




X 




Other Data 
Attributes 


X 




X 




Self-Defining 
Terms 


X 






X 



w. 



jf/ 



C4A — SYMBOLS 



Eurpose 



You can use a symbol tc represent storage locations or 
arbitrary values. 

SYMBOLIC REPRESENTATION ; You can write a symbol in the 
name field of an instruction. Ycu can then specify this 
symfccl in the operands cf other instructions and thus refer 
to the former instruction symbolically. This symbol 
represents a relocatable address. 

You can alsc assign an absolute value to a symbol by coding 
it in the name field of an EQU instructicn with an operand 
whose value is absolute. This allows you to use this 
symbol in instruction operands tc represent registers, 
displacements in explicit addresses, iirirediate data, 
lengths, and implicit addresses with absclute values. Fcr 
details cf these program elements, see E5. The advantages 
of symbolic over numeric representation are: 

1 . Syrrbcls are easier tc remember and use than numerical 
values, thus reducing programming errors and increasing 
programming efficiency. 

2. Ycu can use meaningful symbols to describe the prcgrair 
elements they represent; for example, IKFUT can name a 
field that is to contain input data, or INEEX can name 

a register to be used for indexing. 
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3. You can change the value of one symbol (through an EQU 
instructicn) more easily than you can change several 
numerical values in many instructions. 

4. Symbols are entered into a cross-reference table that 
the assembler prints in the program listing. This tafcle 
helps you to find a symbol in a prcgrair listing, because 
it lists (1) the number of the statement in which the 
syirfccl is defined (that is, used as the name entry) and 

(2) the numbers of all the statements in which the syirbcl 
is used in the operands. 

THE SYMBOL TABLE : The assembler maintains an internal 
table called a syirbcl table. When the assembler prccesses 
your source statements for the first time, the assembler 
assigns an absolute or relocatable value tc every syirbcl 
that appears in the name field of an instruction. The 
assembler enters this value, which norirally reflects the 
setting cf the location counter, into the symbol table; 
it also enters the attributes associated with the data 
represented by the syirbcl. The values of the symbol and 
its attributes are available later when the assembler finds 
this syirbcl cr attribute reference used as a term in an 
operand or expression (Attribute references used as terirs 
are discussed in C4C and CUD below) . 



Specifications 



c 



The three types of symbol recognized 
by the assembler are: 

1. Ordinary symbols 

2. Sequence symbols 

3. Variable symbols. 

ORDINARY SYMBOLS : Ordinary symbols 
can be used in the name and operand 
field of machine and assembler 
instruction statements. They must 
be coded in the format shown in 
the figure to the right. 

BOTES: 

1 . No special characters are allowed 
in an ordinary symbol. 

2. No blanks are allowed in an 
ordinary symbol 







Symbols 




y alphabetic character (letter) 




^0 to 7 alpha 


■neric characters 


■d'R D I N 


S Y M ' 


Examples: 






HERE 


#01 


X 


READER 


#12 


Y 


A001 


@33 


Z 


B002 


$OPEN 


F2A 
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VARIABLE SYMBOLS : Variable symbols 
can only be used in macro processing 
and conditional assembly 
instructions. They must be coded 
in the format shown in the figure 
to the right. 





Var. Sym. 1 






/ ampersand 
/ alphabetic character (letter) 


f&'V'A R S Y M« 

Examples: 

&A &PARAM 
&B & KEYWORD 
&C &CHAR3 





/On, 



Seq. Sym. 



SEQUENCE SYMBOLS ; Sequence symbols 
can only be used in macro processing 
and conditional assembly 
instructions. They must be coded 
in the format shown in the figure 
to the right. 




period 

alphabetic character (letter) 
alphameric characters 



'. ' 'S ff E Q U S Y M 



Examples: 



.SEQ 
.LOOP 11 
.EXIT20 
.T0001 



Symbol Definition 



s % = »> 



An ordinary symbol is considered 
defined when it appears as: 

1. The name entry in a machine or 
assembler instruction of the 
assembler language. 

2. One of the operands of an EXTRN 
or WXTRN instruction. 

NOTE: Ordinary symbols that appear 
in instructions generated from model 
statements at pre-assembly time 
are also considered defined. 
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The assembler assigns a value to 
the ordinary symbol in the name 
fields as follows: 



O o 



1. According to the address of the 
leftmost byte of the storage field 
that contains one of the following: 

a. Any machine or assembler * 
instruction (except the EQU or 
CFSYN instructions) 

b- A storage area defined by 
the ES instruction 

c. Any constant defined by the 
DC instruction 

d. A channel ccirmand word defined 
by the CCW instruction. 

The address value thus assigned 
is relocatable, because the object 
code assembled from these items 
is relocatable; the relocatability 
of addresses is described in E5B. 

2. According to the value of the 
first or only expression specified 

in the operand of an EQU instruction. 
This expression can have a 
relocatable or absolute value, which 
is then assigned to the ordinary 
symbol. The value of an ordinary^ 
symbol roust lie in the range -2 31 
through +2 31 -1. 



Assembler Language 
Statements 


Address Value 
of Symbol 


Object Code 
in Hex 


LOAD 

AREA 
F200 


L 

DS 
DC 




Relocatable 


Address of 
AREA 


3 , AREA A LOAD 1 


►58 3 xxxx 




^ 








F A AREA • 

I / 


xx x x xxxx 




I 




F'200' J 


■ F*?nn— /—a 


• 00 00C8 












FULL 
TWOO 


EQU 

EQU 


AR£A 14k 
F200/W 


r 

FULL / 




R3 


EQU 

L 
A 


3 O 

R3,FULL 
R3,TW00 


Absolute 
R3=3 


Address 
of FULL 




(58 I 3 





XXXX 




I5AI3 





xxxx 


Address of 
TWOO 
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Restrictions en Symbols 



UNIQUE DEFINITION : A symbol must 
be defined only once in a source 
module: 

either in the name field of a 
source statement 

or in the operand field of an 
EXTRN or WXTRN instruction. 

This is true even for a source 
module which contains two or more 
control sections. 

NOTE: The ordinary symbol that 
appears in the name field of an 
OPS¥H or TITLE instruction does 
not constitute a definition of that 
symbol. It can therefore be used 
in the name field of any other 
statement in a source module. 

CONTROL SECTION NAMES : A duplicate 
symbol can, however, be used as 
the name entry of a START, CSECT, 
DSECT, or COM instruction. The 
i first time a symbol is used to name 
these instructions, it identifies 
the beginning of the control section; 
a duplicate use of the syiibol 
identifies the resumption of an 
interrupted control section. 

PREVIOUSLY DEFINED SYMBOL : In some 
instructions the symbols used in 
I their operands must have been defined 
in a previous instruction. 
Previously defined symbols are 
required for the operands of the 
following instructions: 

EQU 

CNOP 

ORG 

EC and DS (in modifier and 
duplication factor expressions) . 







|Q FIRST 


START 


. 




EXTRN 


_£_ 


REG3" — "~~ 
INDEX 
/RES4 


EQU 
EQU 
EQU 


REG3 
4 


.m/^Estmzm 


L 


REG4, TABLE ( INDEX) 


\ 


B 


SECOND 


^rmzM 


DS 


CL256 


SECOND 


CSECT 






L 


REG3,ADRDR 




B 


RESUME1 


A A08©R 


DC 


A (READER) 


^_ 


I A FIRST 


CSECT 




A RESUMEl 


LA 


INDEX, 20 


- 


END 





^ 



o 
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CUB — LOCATION COUNTER REFERENCE 



Purpose 






The assembler runs a location counter 
to assign storage addresses to your 
program statements . It is the 
assemblers equivalent of the 
instruction counter in the computer.' 
You can refer to the current value 
of the location counter at any place 
in a source module by specifying 
an asterisk as a term in an operand. 

THE LOCATION COUNTER ; As the 
instructions and constants of a 
source module are being assembled, 
the location counter has a value 
that indicates a location in storage. 
The assembler increments the location 
counter according to the following: 

1. After an instruction or constant 
has been assembled, the location 
counter indicates the next available 
location. 

2. Before assembling the current 
instruction or constant, the 
assembler checks the boundary 
alignment required fcr it and adjusts 
the location counter , if necessary, 
to indicate the proper boundary. 

3. While the instruction or constant 
is being assembled, the location 
counter value does not change. 

It indicates the location of the 
current data after boundary alignment 
and is the value assigned to the 
symbol , if present, in the name 
field of the statement. 



Location 






Source 


in Hex 






Statements 


000004 




DONE 


DC CL3'SOB' 


©000007S^ 
000008* 


o 


BEFORE 


EQU * 


DURING 


DC F'200' 


OOOOOC© 




AFTER 


EQU * 


000010 




NEXT 


DS D 



4. After assembling the instruction 
or constant, the assembler increments 
the location counter by the length 
of the assembled data tc indicate 
the next available location. 

The assembler maintains a location 
counter for each control section 
in a source module; fcr complete 
details about the location counter 
setting in control sections, see 
E2C. The assembler carries an 
internal location counter value 
as a 4 -byte, 32-bit value, but it 
only uses the low-crder 3 bytes, 
which are printed in the program 
listings. However, if you specify 
addresses greater than 2 2 *»-1 , you 
cause overflow into the high-order 
byte, and the assembler issues the 
error message "LOCATION COUNTER 
OVERFLOW". 
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NOTE: In the figure below, an example of a location counter 
overflow (or wrap-around) is shown. 

A The internal address value of the symbol E is carried as 

a 4-byte value, but the printed location only includes 
A the low-order 3 bytes . 

©The location counter value for instructions or constants 
is usually printed as a 3-byte value. However, the 4 -byte 
A value , with up to 3 leading zeros suppressed, is printed 
- for the addresses specified in the operands of the following 
instructions: EQU, ORG, and USING. Only 3-byte valiie«| 
PSPr are printed for the operands in the above, instructions^ 

you can control the setting of the location counter in 
A a particular control section by using the START or ORG 
instructions. 



^, 



Assembly Listings in Hexadecimal Representation 



LOC 



000000 
000000 
FFFFFE 



000004 



OBJECT CODE 



58506004 



ADDR1 ADDR2 



iUFFFFFE 

00D08 



STMT 



SOURCE STATEMENT 



START 
Q ORG *+X' FFFFFE 1 

L 5,4(,6) 



*** ERROR *** (Location counter overflow) 



07FF 




4 


B 


BR 15 


5 


C 


DC A(B) 


6 


D 


EQU C 



Up to 3 leading zeros 
are suppressed 



'^y 
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Specifications 



The lccaticr counter reference is 
specified by an asterisk (*) . The 
asterisk can be specified as a 
relocatable term according to the 
following rules: 

1. It can only be specified in the 
operands cf: 

a. Machine instructions 

b. The EC and ES instructions 

c. The EQIJ, ORG, and USIKG 
instructions. 

2. It can alsc be specified in 
literal constants (see C5) . 

The value of the location counter 
reference (*) is the current value 
cf the lccaticn counter cf the 
control section in which the asterisk 

(*) is specified as a terir. The 
asterisk has the saire value as the 
address cf the first byte of the 
instruction in which it appears 

(for the value cf the asterisk in 
address constants with duplicaticn 
factors, see G3J) . 



Loc. Ctr Ref 



Location 
in Hex 



Source 
Statements 



000104 HERE B 
000108 B 



' 00011C 
i000 120 



*+8 1 same 
HERE+8 J effect! 



s 



K 



CONSTANT DC 
THERE L 



A( 
3, 



*)0 
=A(*) 



Address 
Value of * 



HERE 



CONSTANT 
THERE 
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C4C — SYMBOL LENGTH ATTRIBUTE REFERENCE , f^^) 



Purpose 

When you specify a symbol length attribute reference, you 
obtain the length of the instruction or data referred to 
by a symbol. You can use this reference as a term in 
instruction operands to: 

1. Specify unknown storage area lengths 

2. Cause the assembler to compute length specifications 
for you 

3. Build expressions to be evaluated by the assembler. 

Specifications 

The symbol length attribute reference must be specified 
according to the following rules: 

1. The format must be L 1 immediately followed by a valid 
symbol or the location counter reference (*) . 

2. The symbol must be defined in the same source module 

in which the symbol length attribute reference is specified. 

3. The symbol length attribute reference can be used in y^ 
the operand of any instruction that requires an absolute 

term. However, it cannot be used in the form L' * in any 
instruction or expression that requires a previously defined 
symbol . 
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The value of the length attribute 
is normally the length in bytes 
of the storage area required by 
an instruction, constant, or field 
represented by a symbol. The 
assembler stores the value of the 
length attribute in the symbol table 
along with the address value assigned 
to the syirbcl. 

When the assembler encounters a 
symbol length attribute reference, 
it substitutes the value of the 
attribute from the symbol table 
entry for the symbol specified. 

The assembler assigns the length 
attribute values to symbols in the 
name field of instructions as 
follows : 



Length Attr. 






For machine instructions, it assigns 
either 2, 4, or 6, depending on 
the format of the instruction. 

For the DC and PS instructions, 
it assigns either the implicit or 
explicitly specified length. The 
length attribute is not affected 
by a duplication factor. 

For the ECU instruction, it assigns 
the length attribute value of the 
leftmost or only term of the first 
expression xn the first operand, 
unless a specific length attribute 
is supplied in a second operand. 

Only one operand is allowed in the 
EQjO instruction. 

Note the lergth attribute values 
of the following terms in an EQU 
instruction: 



Cr * self-defining terms 



location counter reference 



L'* 



The length attribute of the location 
counter reference (L**) is equal 
to the length attribute of the 
instruction in which the L** appears. 

For the remaining assembler 
instructions, see the specifications 
for the individual instructions. 



Source Module 



MAC HA 
MACHB 
MACHC 

TO 

FROM 

ADCON 

CHAR 

DUPL 



REL0C1 
REL0C2 
ABS0L1 
ABS0L2 

SDTl 
SDT2 
SDT3 

ASTERISK 

LOCTREF 



MVC 

L 

LR 

DS 
DS 
DC 
DC 
DC 



EQU 
EQU 
EQU 
EQU 

EQU 
EQU 
EQU 

EQU 

EQU 



TO, FROM 
3, ADCON 
3,4 

CL80 
CL240 
A (OTHER) 
C ' YUKON • 
3F'200' 




'*+A-B 

(pits**- 

§►+10 



Value of Symbol 
Length Attribute 
(at assembly time) 



L'MACHA A 
L 'MACHB I 
L 1 MACHC 

L'TO 

L ' FROM -^ 

l' adcon mm 

L'CHAR ^^ 
L'DUPL 



L'RELOCl 
L'RELOC2 
L'ABSOLl 
L'ABS0L2 

L'SDTl 
L'SDT2 
L'SDT3 



80 

240 

4 

5 

4 



80 

80 

24 

240 



L'ASTERISK ^fel 
L ' LOCTREF A 1 



LENGTH1 DC A(L'* ) 

ILENGTH2 MVC TO(L'» ) ,FROM 
LENGTH3 MVC TO(L'TO-20) ,FROM 



L'* 14 

L'LENGTHl A (4 
L'* ^ r 16 
L'TO 80 
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CUB — OTHER ATTRIBUTE REFERENCES 



There are other attributes which describe the 
characteristics and structure of the data you define in 
a program. For example, the kind of constant you specify 
or the number of characters you need to represent a value. 
These other attributes are the type (T*), scaling (S f ), 
integer (I*) , count (K 1 ) , and number (N f ) attributes. 

NOTE: You can refer to these attributes only in conditional 
assembly instructions and expressions; for full details, 
see L1B. 



CUE — SELF- DEFINING TERNS 



Purpose 



A self-defining term allows you to specify a value 

explicitly. With self-defining terms, you can specify 

decimal, binary, hexadecimal, or character data. These 

terms have absolute values and can fce used as absolute 

terms in expressions to represent bit configurations, ^_^ 

absolute addresses, displacements, length or other fj 

modifiers, or duplication factors. "%j? 
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Specifications 



Self-Defining 



GEKEBAI PULES ; Self-defining terirs: 

• Represent rrachine language binary 
values 

• Are absolute terirs; their values 
do not change upon prcgrarr 
relocation. 



C o 



The assembler carries the values 
represented by self-defining terirs 
to 4 bytes or 32-bits; the high- 
crder bit is the sign bit. 

Values are carried to 3 bytes or 
24 bits. 





Self-Defining 


Decimal 


Binary 


Term 


Value 


Value f^ 


15 


15 


^W 

1111 


241 


241 


11110001 


B'llll' 


15 


1111 


B'llllOOOl' 


241 


11110001 


B'lOOOOOOOl' 


257 


100000001 


XT' 


15 


1111 


X'Fl' 


241 


11110001 


X'101 1 


257 


100000001 


C'l* 


241 


11110001 


C'A' 


193 


11000001 


CAB' 


49,602 


1100000111000010 




— 4 bytes _j 






* (32 bits) *" 






value bits 




31 


30 24 16 8 




. 
















e 






[ value bits ) 




(sign bit j 




1=Negative Value 




0=Positive Value 



EECIK3L ; P. deciiral self-defining 
term is an unsigned decimal number. 
The assembler allows: 

^m • High-crder zercs 

^fr • A maximum of 10 deciiral digits 

• A range of values from through 
Q 2,147,483,647 . 

: :®Q& • h maximum of 8 decimal digits. 

♦ A range of values from through 
<16,777,215. 
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EIKABY ; A binary self-defining 
terir irust be ceded in the format 
shown in the figure to the right. 
The assembler: 

4fr • Assembles each binary digit as 
™ it is specified 

0^ • Allows a maximum of 32 binary 
^^ digits 

• Allows a range of values from 

O -2, 147, 483,618 through 
2,m,n8i,&rr. 

DOS • Allows a maxiieusi cf 2ft binary 
digits. 

• Allows a range of values from 
through 16,777,215. 

NOTE: When used as an absolute 
term in expressions, a binary self- 

O defining term has a negative value 
if the high-order bit is 1 . 



apostrophes must enclose digits 

I 

B'110011 101' 

\ 



binary 



1 to 32 binary digits 



Examples 



B'lOlOlll* 



B'lllOlOlOlll' 



High-order 
sjjgn bit 

B'tllll...!!!' 

II 32 digits M^ 



B'lOOOO. . .000' 



32 digits 



Binary Value 



g^ niQimjj 



li noioioim 






= 2 31 -1 
\ 

o 

\ 

= -?31 



\^^ 
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BEXAEECIMAL : A hexadecimal self- 
defining terir roust be ceded as shown 
in the figure to the right. The 
asseirtler: 

• Assembles each hexadecimal digit 
^fc intc its 4-bit binary equivalent 
^^ (listed in the figure to the right) 

O* Allows a iraxiiruir cf 8 hexadecimal 
digits 

• Allows a range cf values from 

Q -2,147,483,648 through 2 , 147,483,647 . 

•Allows a maximum of 6 hexadecimal 



X Allows a range cf values from 
^ through 16,777,215, 

NOTE: When used as an absolute 
term in an expression, a hexadecimal 
self-defining terir has a negative 
value if the high-order tit is 1 . 



, apostrophes must enclose digit 
X'FF...F56' 



hexadecimal 



Conversion Table: 



1 to 8 hexadecimal digits 







4-bit 


Hexadecimal 


Decimal 


Binary 
Representation 


Digit 


Equivalent 








0000 


1 


1 


0001 


2 


2 


0010 


3 


3 


0011 


4 


4 


0100 


5 


5 


0101 


6 


6 


0110 


7 


7 


0111 


8 


8 


1000 


9 


9 


1001 


A 


10 


1010 


B 


11 


1011 


C 


12 


1100 


D 


13 


1101 


E 


14 


1110 


F 


15 


1111 



Examples: 



Binary Value 




iuihiqioi 



X'A 



X ' FFA ' 



looootioioi 



iniiiiiiinoTol 



8 digits' 



X »7FFFFFFF' = 2 31 -1 

o 

X'80000000' = -2 31 

o 
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CHARACTEB: P. character self-defining 
terir irust be ceded as shewn in the 
figure to the right. The assembler: 



• Allows any of the 256 punch 
combinations when using punched 
cards as input. This includes the 
printable characters, that is, 
blanks and special characters. 

• Assembles each character into 
its 8- bit binary equivalent. (A 
table of characters and their binary 
equivalents can be found in Appendix 
I) • 

• Requires that twe ampersands 

or apostrophes be specified in the 
character sequence fcr each ampersand 
or apostrophe required in the 
assembled term. 

• Allows a maximum of 4 characters. 



DOS • Allows a »axi»tSB of 3 characters. 



..apostrophes must enclose characters 

C ^ABCD ' 

\ 1 to 4 characters 
character t^PUm 

Examples: 


Character 

self-defining 

term 


Characters 
Assembled 


Hexadecimal 
Value 


Binary 
Value 


C'A' 

C'l' 
C» ' 

C'#' 

cv 

© 

C'&&' 
c ' ' ' ' 

C'L' 'A 1 

pn n i i 

C ' FOUR ' 

O 


1 
(blank) 
# 

@ 

P 

& 
t 

L'A 
n 

FOUR 


X'Cl' 

— — ©- 

X'Fl' 
X'40' 
X'7B' 
X'7C 

X'50' 
X f 7D' 
X'D37DC1' 
X'7D7D' 

X'C6D6E4D9' 


11000003, 

11110001 
01000000 
01111011 
01111100 

01010000 
01111101 



o 



^.y 



C5 - Literals 



Purpose 



You can use literals as operands 
in order to introduce data into 
your program. However, you cannot 
use a literal as a terra in an 
expression. The literal represents 
data rather than a reference to 
data. This is convenient, because 

1 . The data ycu enter as numbers 
for computation, addresses, or 
messages to be printed is visible 
in the instruction in which the 
literal appears, and 

2. You avoid defining constants 
elsewhere in your source module 
and then using their symbolic names 
in machine instruction operands. 



L 1,=F'200' 

L 2,=A(SUBRTN) 

MVC MESSAGE (16) ,=C THIS IS AN ERROR' 
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The . assembler assembles the data 
specified in a literal into a 
"literal pool" (fully described 
in H1B) . It then assembles the 
address of this literal data in 
the pool into the object code of 
the instruction that contains the 
literal specification. Thus the 
assembler saves you a programming 
step by storing your literal data 
for you. The assembler also 
organizes literal pools efficiently 
so that the literal data is aligned 
on the proper boundary alignment 
and occupies the minimum amount 
of space. 

LITERALS, CONSTANTS, AND SELF- 
DEFINING TERMS ; Do not confuse 
literals with constants or self- 
defining terms. They differ in 
three important ways: 

1. In where you can specify them 
in machine instructions, that is, 
whether they represent data or an 
address of data. 



c 



2. In whether they have relocatable 
or atsolute values. 

3. In what is assembled into the 
object code of the machine 
instruction in which they appear. 

The figure to the right illustrates 
the first two points. 

^P • A literal represents data. 

O* A constant is represented ty 
its relocatable address. Note that 
a symbol with an absolute value 
-^ does not represent the address of 
Da constant, but represents immediate 

O data (see D5D) or an absolute 
address. 

^^. * A self-defining term represents 
mm data and has an absolute value. 



Compare: 

A literal with a relocatable address 



o 

3,=F'33' 1 
3,F3^ J 

O 



same effect 



F33 



DC F'33' 



A Literal with a self-defining term 
and a symbol with an absolute value 

o 

MVC FLAG^X'UO' 1 
MVI FLAG,«»W 
MVI FLAG, ZERO*jf 

© 

FLAG DS X 
ZERO EQU X'OO 1 



same effect 



A symbol having an absolute address value 
with a self-defining term ^^ 

o 

LA 4,L0C0RE 1 
LA 4 ,PHi J 

LOCORE EQU 1000 



same effect 
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The figure to the right illustrates 
the third point. 

• The address of the literal , 
rather than the literal data itself 
is assembled into the object code. 

• The address of a constant is 
asseirbled into the object code. 
Note that when a symbol with an 
absolute value represents immediate 
data, it is the absolute value that 
is assembled into the object code. 

• The absolute value of a self- 
defining term is assembled into 
the object code. 



in Hex 



Loc 



Source Statements 



248 
24C 

250 



LITERAL L 3,=F :< ',2C|Q 



RELCON L 3,F2J f < 



Object Code 
in Hex 



displacement 
base \ 
158 13oTc 12501 



ABSCON TM BXTJ5,,FXASU5N 



SELFDT TM BYTE , X ' B8" 



FLAGCON EQU X'B8' 
F200 DC F'200' 
BYTE DS X 
LTORG 
I000000C8I = F'200" 




Literal 
Pool 



/V' 
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Specifications 



A literal must be ceded as shown 
in the figure to the right. 

The literal is specified in the 
same way as the operand of a DC 
instruction (for restrictions see 
G3C) . 

GENERAL RULES FOR LITERAL USAGE: 
A literal is not a term and can 
be specified only as a complete 
operand in a machine instruction. 
In instructions with the RX format 
they must not be specified in 
operands in which an index register 
is also specified. 



Because literals provide "read-only 1 
data, they irust not be used: 

1. In operands that represent the 
receiving field of an instruction 
that modifies storage 

2. In any shift or I/O instructions, 



Literals 





Literal Specification 




^tixjes'FS' 1 


Subfields: 


implication type modifiers nominal \ 
factor value 1 


o 



C6 - Expressions 



C6A — PURPOSE 



You can use an expression to specify: 

■■ An address 

^m An explicit length 

^P A modifier 

^B A duplication factor 

d!fr A complete operand 

You can write an expression with 
a simple term or as an arithmetic 
combination of terms. The assembler 
reduces multi terra expressions to 
single values . Thus , you do not 
have to compute these values 
yourself . 



9 



EQU 



X-Y+13-P/Q 



/ 



MVC _ I TO+L'TO-L' FROM , (L' FROM) , FROM 

£ks 



DS 



(X-YJXLC P/Q-IO. ) 



y 
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Expressions have absolute or relocatable values. Whether 
an expression is absolute or relocatable depends on the 
value of the terms it contains. You can use the absolute 
or relocatable expression described in this subsection 
in a machine instruction or any assembler instruction ether 
than a conditional assembly instruction. The assembler 
evaluates relocatable and absolute expressions at assembly 
time. Throughout this manual, the word "expression" refers 
to these types of expression. 

NOTE: There are three types of expression that you can 
use only in conditional assembly instructions: arithmetic, 
logical, and character expressions. They are evaluated 
at pre-assembly time. In this manual they will always 
be referred to by their full names; they are described 
in detail in LH. 



v^_y 
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C6B — SPECIFICATIONS 



The figure below defines both absolute and relocatable 
expressions. 

(NOTE: The relocatable values that are paired must have 

the opposite sign after the resolution of all unary 

(operators. *• 



Expressions 






Absolute 
Expression 




(xx) — H CMiBB } +~ 



m • Rel. Exp. 



Rel. Exp. 

ottzy 

Pairing of 

Relocatable 

Values 



Absolute 
Term 



Abs. Exp 

+ 
Abs .Exp 



Abs. Exp 
Abs. Exp 



Abs. Exp 
Abs. Exp 



Abs. Exp 

/ 
Abs. Exp 



(Abs.Exp) 



CAN BE 



Ordinary 
Symbol - 
Absolute 
Value 



Self- 
Defining 
Term 



Symbol 
Length 
Attribute 



Relocatable 
Expression 



| CAN BE | «- 



Relocatable 
Term 



L I ^ J 



CAN BE 




Rel.Exp 




Rel. Exp 


+ 


or 


— 


Abs. Exp 




Abs. Exp 



(Rel. Exp) 



+ Rel. Exp 



Ordinary 
Symbol - 
Relocatable 
Value 



Location 

Counter 

Reference 




r Rel. Exp 



Unary operators 



+ Abs. Exp 




Abs. Exp 



Unary operators 



Operators Allowed 

Unary: + Positive 

— Negative 

Binary: + Addition 

— Subtraction 

* Multiplication 
/ Division 



Abs. Exp = Absolute Expression 
Rel. Exp = Relocatable Expression 
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Absolute and Relocatable Expressions 



An expression is absolute if its 
value is not changed fcy program 
relocation; it is relocatable if 
its value is changed upon program 
relocation. A description of the 
factors that determine whether an 
expression is absolute or relocatable 
follows . 

PAIRED RELOCATABLE TERMS ; An 
expression can be absolute even 
though it contains relocatable 
terms, provided that all the 
relocatable terms are paired. The 
pairing of relocatable terms cancels 
the effect of relocation. The 
assembler reduces paired terms. to 
single absolute terms in the 
intermediate stages of evaluation. 
The assembler considers relocatable 
terms as paired under the following 
conditions: 

0« The paired terms must be defined 
in the sarre control section of a 
source module (that is , have the 
same relocatability attribute) . 

©• The paired terms must have 
opposite signs after all unary 
operators are resolved. In an 
^^ expression, the paired terms do 
^y not have to be contiguous , that 
is, other terms can come between 
the paired terms. 

• The value represented fcy the 
^■paired terms is absolute . 



Source Module 



Can be 
paired 



Can be 
paired \ 



FIRST 


CSECT 




A 


DS 


F 


B 


DS 


F 


C 


OS 


F 


LOCTREF 


EQU 


* 


ABSA 


EQU 


X'F' 


ABSB 


EQU 


300 


ABSC 


EQU 


C'A' 



SECOND 


CSECT 




D 


* 

DS 


X 


E 


DS 


X 


F 


DS 


X 



END 



Examples: 



Paired Relocatable Terms 




LOCTREF-C 

D-E 

F-D 



Unpaired Relocatable Terms 



B 

C 

LOCTREF 

D 



Absolute 



A+ABSA-B 

D-E+ABSC 
F-D+B-C 

paired paired 



\y 



Relocatable 
Expressions 

Unpaired 

B+ABSA 
<$+X ' FF * 
i-5*(B-C) 
paired 
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Abs. Exp. 



o 



Absolute Expressions 



The assembler reduces an absolute 
expression to a single absolute 
value if the expression: 

1. Is composed of a symbol with 
an absolute value , a self-defining 
term, or a symbol length attribute 
reference, or any arithmetic 
► combination of absolute terms . 

|2. If it contains relocatable terms , 
alone or in combination with absolute 
terms, and if all these relocatable 

| terms are paired. 



Source Module 



FIRST 


CSECT 




A 


DC 


F'2' 


B 


DC 


F'3' 


C 


DC 


F'4' 


ABSA 


EQU 


100 


ABSB 


EQU 


X'FF' 


ABSC 


EQU 


B-A 




. 


Paired 


ABSD 


EQU 
END 


*-A' 



Absolute 
Expressions 



ABSA 

15 

L'A 



A {absa+absc-absc*15 

© 



©{B-A _jL 
lABSA+15-B+C-ABSD/ (C-A+ABSA) 
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Belocatable Expressions 



A relocatable expression is one 
Whose value changes, for example, 
by a 1000, if the object module 
into which it is assembled is 
relocated 1000 bytes away from its 
originally assigned storage area. 
The assembler reduces a relocatable 
expression to a single relocatable 
value if the expression: 

1. Is composed of a single 
relocatable term, or 

2. Contains relocatable terms , alone 
or in combination with absolute 
terms, and: 

a. All the relocatable terms 
but one are paired. Note that 
the unpaired term gives the 
expression a relocatable value; 
the paired relocatable terms 
and other absolute terms 
constitute increments or 
decrements to the value of the 
unpaired term. 

b. The relocatability attribute 
of the whole expression is that 
of the unpaired terra. 

c. The sign preceding the unpaired 
relocatable term must be positive, 
after all unary operators have 
been resolved. 

COMPLEX RELOCATABLE EXPRESSIONS : 
Complex relocatable expressions, 
unlike relocatable expressions, 
can contain: 

a. Two or more unpaired 
relocatable terms or 

b. An unpaired relocatable term 
preceded by a negative sign. 

Complex relocatable expressions 
can be used only in A- type and Y- 
type address constants (see G3J) . 



/f^\ 



Reloc. Exp. 



Source Module 



FIRST 


CSECT 




A 


D*C 


H'2» 


B 


DC 


H'3.' 


C 


DC 


H'4' 


ABSA 


EQU 


10 


ABSB 


EQU 


*-A 


ABSC 


EQU 
END 


10*(B-A) 



Relocatable Expresssions: 

(Belong to control section named FIRST 
and have same relocatable attribute as 
A, B and C) 



;t+ABSA+10 

B-+A-N*-10*ABSC 
- 1 \ 



oo 

B-A+€+100*ABSA+ABSA/ (C-A) 




•V 



y 



^ 
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Rule a for Coding Expressions 



The rules for coding an absolute 
or relocatable expression are: 

1 . Both unary (operating on one 
value) and binary (operating on 
two values) operators are allowed 
in expressions. 

^ 2. An expression can have one or 
^P more unary operators preceding any 
term in the expression or at the 
beginning of the expression. 



3. An expression must not begin 
with a binary operator , nor can 
it contain two binary"*operators 
in succession. 

4. An expression must not contain 
two terms in succession . 

5. No blanks are allowed between 
an operator and a term nor between 
two successive operators. 

6. An expression can contain up 
to 19 unary and binary operators 
and up to 6 levels of parentheses. 
Note that parentheses that are part 
of an operand specification do not 
count toward this limit. 

lso 1 5 unary and binary operators 

7. A single relocatable term is 
not allowed in a multiply or divide 
operation. Note that paired 
relocatable terms have absolute 
values and can be multiplied and 
divided if they are enclosed in 
parentheses. 

8. A literal is not a valid term 
and is therefore not allowed in 
an expression. 



Operators 



Unary 


+ ," 


Binary 


+ »-.*,/ 



§F**-- ABS 
'**REL+*ABS 




-ABS 
* - REL-ABS 



Context determines whether 
+ or - is unary or binary 
operator 



ABS0/ABSD*15 
REL+*ABS 



A + B 

ABSC/ABSD + 15 
REL-ABS 



Multiply 



► *•*£ 3 
* + 3 



INVALID 
VALID 



Location counter 
Reference 




INVALID 

VALID 

INVALID 



Context determines whether 
an asterisk (*) is the binary 
operator for multiplication 
or the location counter 
reference 



Leftmost operator between 
two terms is binary 



X'FF' (10* A) 



M 



15B'101' 



INVALID 



INVALID 



tP 
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Evaluation of Expressions 



The assembler reduces a multiterm 
expression to a single value as 
follows: 

1. It evaluates each term. 

2. It performs arithmetic operations 
from left tc right. However: 

a. It performs unary operations 
before binary operations, and 



Ob. It performs the binary 
operations of multiplication 
and division before the binary 
-^ operations of addition and 
O subtraction. 

3. In division , it gives an integer 
result; any fractional portion is 
dropped. Division by zero gives 
0. 



Absolute Expressions 




A=10 
B=2 



A+10/B ,- 
(A+10)/B 



/ / 

10 + 10/2 b: 



(10+10) /2c£>2 0/2 =*, 



A=10 A/2 
A=ll A/2 



A=l 



A/2 J 



=£» 



10 * A/2 ■ — *. 10 * 1/2 c^ 10/2=4. 



Value of 
Expression 



+50 



15 
10 

5 
5 


5 



4. In parenthesized expressions, 
the assembler evaluates the inner 
most expressions first and then 
considers them as terms in the next 
outer level of expressions. It £| 
continues this process until the ™ 
outermost expression is evaluated. 

5. A term or expression's 
intermediate vaiue and computed 
result must lie in the range of 
-23' through ♦23''- 1. 

6- The ecwpitea rwftfc is ±hm-' [ M 
t*tt*H5ate<S tc a 2#~feit ^mlm that^* 

lies between # and If # T??«21§* '■:''& 

NOTE: It is assuired that the 
assembler evaluates paired 
relocatable terirs at each level 
of expression nesting. 




A- (X • FF »* 2+B- (C/2*&*e) 

o 




W 



hj? 
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Part II: Functions and Coding of Machine Instructions 

'\J SECTION D: MACHINE INSTRUCTIONS 
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(j Section D: Machine Instructions 



This section introduces the main functions of the machine 
instructions and provides general rules for coding them 
in their symbolic assembler language format. For the 
complete specifications of machine instructions, their 
object code format, their coding specifications, and their 
use of registers and virtual storage (see GLOSSARY) areas 
see the Principles of Operation manuals: 

• IBM System/360 Principles of Operation, Order No. GA22- 
6821 

• IBK System/370 Principles of Operation, Order No. GA22- 
7000 



Dl - Functions 






At assembly time, the assembler converts the symbolic 
assembler language representation of the machine 
instructions to the corresponding object code. It is this 
object code that the computer processes at execution time. 
Thus, the functions described in this section can be called 
execution time functions. 

Also at assembly time, the assembler creates the object 
code of the data constants and reserves storage for the 
areas you specify in your DC and ES assembler instructions 
(see G3) . At execution time, the machine instructions 
can refer to these constants and areas, but the constants 
themselves are not executed. 
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E1A — FIXED- POINT ARITHMETIC 



Purpose 



^\ 



You use fixed-point instructions 
when you wish to perform arithmetic 
operations on data represented in 
binary form. These instructions 
treat all numbers as integers. 
If they are to operate upon data 
representing mixed numbers (such 
as 3.14 and 0.235) ycu must keep 
track of the decimal point yourself. 
For your constants ycu must provide 
the necessary number of binary 
positions to represent the fractional 
portion of the number specified 
by using the scale modifier (see 
G3B) . 



Operations Performed 



Fixed-point instructions allow you 
to perform the operations listed 
in the figure to the right. 



Data Constants Used 



In fixed-point instructions, you 
can refer to the constants listed 
in the figure to the right. 



NOTE: 



Except for the conversion 



operations , fixed-point arithmetic 
is performed on signed binary values. 



Fixed - Point 
Operations 


Mnemonic 
Operation Codes 


Add 


AR,A,AH,ALR,AL 


Subtract 


SR,S,SH,SLR,SL 


Multiply 


MR, M, MH 


Divide 


DR, D 


Arithmetic Compare 
(taking sign into 
account) 


CR, C, CH 


Load into registers 


LR, L, LH, LTR, LCR, LPR, LNR, LM 


Store into areas 


ST, STH, STM 


Arithmetic Shift of 
binary contents of 
registers to left or 
right (retaining 
sign) 


SLA, SRA, SLDA, SRDA 


Convert (packed) 
decimal data to 
binary 




CVB 


Convert binary data 
to (packed) decimal 
data 


€ 


I CVD 


Constants Used 


Type 


Fixed-Point 


Hand F 


Binary 


B 


Hexadecimal 


X 


Character 


C 


Decimal (packed) 


P 


Address 


Y,A,S, VandQ 



\^jj 



1 
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C1E — » EECIKAL ARITHMETIC 



c 



fur pose 



You use the deciiral instructions 
when you wish to perform arithmetic 
operations en data that has the 
binary equivalent of decimal 
representation, either in packed 
or zoned form. These instructions 
treat all numbers as integers. 
For example, 3.14, 31. 4, and 314 
are all processed as 314. You must 
keep track cf the decimal pcint 
yourself. 



O perations Performed 



Decimal instructions allow you to 
perform the operations listed in 
the figure to the right. 



Eata Constants Used 



In decimal instructions ycu can 
refer tc the constants listed in 
the figure to the right. 

NOTE : Except fcr the conversion 
operations , decimal arithmetic is 
performed on signed packed decimal 
values. 



Decimal 
Operations 


Mnemonic Operation 
Codes 


Add 


AP 


Subtract 


SP 


Multiply 


MP 


Divide 


DP 


Arithmetic Compare 
(taking sign into 
account) 


CP 


Move decimal data 
with a 4-bit offset 


MVO 


Shift decimal data 
in fields to left or 
right 


SRP 


Set a field to zero 
and add contents 
of another field 


ZAP 


Convert zoned to » 
packed decimal 
data 

Convert packed to 
zoned decimal 
data 


o 


PACK 
UNPK 


Constants Used 


Type 


Decimal (packed) 
(zoned) 


P 

Z 
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E1C — FLOATING- POINT ARITHMETIC 
Fur pose 



You use floating-point instructions 
when ycu wish tc perform arithmetic 
operations on binary data that 
represents bcth integers and 
fractions. Thus, you do net have 
to keep track cf the deciiral point 
in ycur cemputatiens. Floating- 
point instructions also allow ycu 
to perfcrir arithmetic operations 
on both very large numfcers and very 
small numbers, with greater precision 
than with fixed-point instructions. 



Operations Pe r formed 



Floating-pcint instructions allow 
you to perform the operations listed 
in the figure tc the right. 



Cata Constants Used 



In floating-point instructions, 
you can refer tc the constants 
listed in the figure to the right. 

KOTE: Floating- point arithmetic 
is performed on signed values that 
must have a special floating-point 
format. The fractional portion 
of floating-point numbers, when 
used in addition and subtraction , 
can have a normalized (no leading 
zeros) or unncrmalized format. 



Floating - Point 
Operations 


Mnemonic Operation 
Codes 


Add ) 

o 


ADR, AD, AER, AE, AWR 
AW,AUR,AU,AXR 


Subtract J 


SDR,SD,SER,SE,SWR, 
SW,SUR,SU,SXR 


Multiply 


MDR, MD, MER, ME, MXR, 
MXDR,MXD 


Divide 


DDR,DD, DER.DE 


Halve 
(division by 2) 


HDR.HER 


Arithmetic Compare 
(taking sign into 
account) 


CDR,CD,CER,CE 


Load into floating - 
point registers 


LDR, LD, LER, LE, LTDR, 
LTER, LCDR, LCER, LPDR, 
LPER,LNDR,LDER,LRDR, 
LRER 


Store into areas 


STD, STE 


Constants Used 


Type 


Floating - Point 


E, D, and L 



Vy 



.•y 
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D1D — LOGICAL OPERATIONS 



Purpose 



c 



You can use the logical instructions 
to introduce data, move data, or 
inspect and change data. 



Operations Performed 



The logical instructions allow you 
to perform the operations listed 
in the figure to the right. 



Logical 
Operations 


Mnemonic Operation 
Codes 


Move 


MVI, MVC, MVN, MVZ, MVCL 


Logical Compare 
(unsigned binary 
values) 


CLR,CL,CLI,CLC, CLCL, 
CLM 


AND (logical 
multiplication) 


NR, N, NI,NC 


OR (logical 
addition) 


OR, 0,01. OC 


Exclusive OR 
but not both) 


XR,X, XI, XC 


Testing binary 
bit patterns 


TM 


I nserting characters 
into registers 


IC, ICM 


Store characters 
into areas 


STC, STCM 


Load address into 
register 


LA 


Logical Shift of 
unsigned binary 
contents of 
registers to left or 
right 


SLL.SRL,SLDL,SRDL 


Replace argument 
values by corresponding 
function values from 
table (translate) 


TR.TRT 


Edit (packed and 
zoned decimal data) 
values in preparation 
for printing 


ED, EDMK 
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D1E — BRANCHING 



Purpose 



You can use several types of 
branching instructions, combined 
with the logical instructions listed 
in D1D, to code and control loops, 
subroutine linkages, and the sequence 
of processing. 



Operations Performed 

The branching instructions allow 
you to perform the operations listed 
in the figure to the right. 

NOTE: Additional mnemonics for 
| branching on condition are described 
in section E1H below. 



Branching 
Operations 


Mnemonic Operation 
Codes 


Branch depending ^ 
on the results of 
the preceding 
operation (that 
sets the condition 
code) 





BCR, BC 


Branch to a 
subroutine with a 
return link to 
current code 


BALR, BAL 


Branch according 
to a count con- 
tained in a register 
(count is decremented 
by one before deter- 
mining course of 
action) 


BCTR, BCT 


Branch by comparing 
index value to fixed 
comparand, (index 
incremented or de- 
cremented before 
determining course 
of action) 


BXH, BXLE 


Temporary Branch in 
order to execute a 
specific machine 
instruction 


EX 



w 
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C1F — STATUS SWITCHING 



Purpose 



o 



You can use the status switching 
instructions to communicate between 
your prograir and the system control 
program. However, some of these 
instructions are privileged 
instructions and you can use them 
only when the CPU is in the 
supervisor state, but not when it 
is in the problem state. The 
privileged instructions are marked 
with a "p" in the figure to the 
right. 



O perations Performed 



The status switching instructions 
allow you to perform the operations 
listed in the figure to the right. 



Status Switching 
Operations 


Mnemonic Operation 
Codes 


Load program status information 
Load seauence of control reaisters 


P LPSW 
P LCTL 


Set bit patterns for condition code 
and interrupts for program 

Set bit patterns for channel usage 
by system 

Set protection key for a block of 
storage 

Set time-of-day clock 


SPM 
P SSM 

P SSK 

P SCK 


Insert protection Jsgy,for storage 
into a register 


P ISK 


Store time-of-day clock 

Store identification of channel 
or CPU 

Store (save) sequence of control 
registers 


STCK 
P STIDC.STIDP 

P STCTL 


Call supervisor for system 
interrupt 

Call monitor for interrupts de- 
pending on contents of 
control register 


SVC 
MC 


Test bit which is subsequently 
set to 1 

Write or Read directly to or 
from other CPU's 


TS 
P WRD, RDD 


Set Clock Comparator 
Store Clock Comparator 
Set CPU Timer 
Store CPU Timer 


P SCKC 

P :ckc 

P SPT 
P STPT 


Store Then AND System Mask 
Store Then OR System Mask 


P STNSM 
P STOSM 
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DIG — INPUT/OUTPUT 






Purpose 



You can use the input/output 
instructions, instead of the IBM- 
supplied system macro instructions, 
when you wish to control your input 
and output operations xrore closely. 



Operations Performed 



The input or output instructions 
allow you to identify the channel, 
or the device on which the input 
or output operation is to be 
performed. The operations performed 
are listed in the figure to the 
right. However, these are privileged 
instructions, and you can only use 
them when the CPU is in the 
supervisor state, but not when it 
is in the problem state. 



Input or Output 
Operations 


Mnemonic Operation 
Codes 


Start I/O 

Halt I/O 

Test state of channel 
or device being used 

Halt Device 


SIO, SIOF 

HIO 

TIOJCH 

HDV 
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D1 H — BRANCHING WITH EXTENDED MNEMONIC CODES 



Purpose 

The branching instructions described below allow you to 
specify a mnemonic code for the condition on which a branch 
is to occur. Thus, you avoid having to specify the mask 
value required by the EC and ECR branching instructions. 
The assembler translates the mnemonic code that represents 
the condition into the mask value, which is then assembled 
in the object code of the machine instruction. 

Specifications 

The extended mnemonic codes are given in the figure on the 

opposite page. 

OThey can be used as operation codes for branching 
instructions, replacing the BC and BCR machine instruction -^ 
codes. Note that the first operand of the BC and BCR ^p 
©instructions must not be present in the operand field of 
the extended mnemonic branching instructions. 

^B NOTE: The addresses represented are explicit addresses ; 

however, implicit addresses can also be used in this type ^ N 

of instruction. ( ) 



J? 
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Extended Code 



Meaning 



Format (Symbolic) Machine 

Instruction Equivalent 



© o 









B 


*D2(X2 


,B2) 


BR 


R2 




NOP 


D2(X2 


,B2) 


NOPR 


R2 




BH 


D2(X2 


,B2) 


BHR 


R2 




BL 


D2(X2 


,B2) 


BLR 


R2 




BE 


D2(X2 


rB2) 


BER 


R2 




BNH 


D2(X2 


,B2) 


BNHR 


R2 




BNL 


D2(X2 


,B2) 


BNLR 


R2 




BNE 


D2(X2 


rB2) 


BNER 


R2 





I Unconditional Branch 
1 No Operation 



Used After Compare Instructions 



Branch on High 
Branch on Low 
Branch on Equal 
Branch on Not High 
Branch on Not Low 
Branch on Not Equal 



RX 
RR 
RX 
RR 



BC 15,D2(X2,B2) 

BCR 15, R2 

BC 0,D2(X2,B2) 

BCR 0,R2 



RX 


BC 


2,D2(X2,B2) 


RR 


BCR 


2,R2 


RX 


BC 


4,D2(X2,B2) 


RR 


BCR 


4,R2 


RX 


BC 


8,D2(X2,B2) 


RR 


BCR 


8,R2 


i\A 


BC 


13,D2(X2,B2) 


RR 


BCR 


13, R2 


RX 


BC 


11,D2(X2,B2) 


RR 


BCR 


11, R2 


RX 


BC 


7,D2(X2,B2) 


RR 


BCR 


7,R2 






BO 

BOR 

BP 

BPR 

BM 

BMR 

BNP 

BNPR 

BNM 

BNMR 

BNZ 

BNZR 

BZ 

BZR 

BNO 

BNOR 



D2(X2,B2) 

R2 

D2(X2,B2) 

R2 

D2(X2,B2) 

R2 

D2(X2,B2) 

R2 

D2(X2,B2) 

R2 

D2(X2 / B2) 

R2 

D2(X2,B2) 

R2 

D2(X2,B2) 

R2 



BO 


D2(X2 


rB2) 


BOR 


R2 




BM 


D2(X2 


rB2) 


BMR 


R2 




BZ 


D2(X2 


,B2) 


BZR 


R2 




BNO 


D2(X2 


rB2) 


BNOR 


R2 




BNM 


D2(X2 


,B2) 


BNMR 


R2 




BNZ 


D2(X2 


,B2) 


BNZR 


R2 





Used After Arithmetic Instructions 

Branch on Overflow 
Branch on Plus 
Branch on Minus 
Branch on Not Plus 
Branch on Not Minus 
Branch on Not Zero 
Branch on Zero 
Branch on No Overflow 

Used After Test Under Mask Instructions 

Branch if Ones 
Branch if Mixed 
Branch if Zeros 
Branch if Not Ones 
Branch if Not Mixed 
Branch if Not Zeros 



RX 


BC 


1,D2(X2,B2) 


RR 


BCR 


1,R2 


RX 


BC 


2,D2(X2,B2) 


RR 


BCR 


2,R2 


RX 


BC 


4,D2(X2,B2) 


RR 


BCR 


4,R2 


RX 


BC 


13,D2(X2,B2) 


RR 


BCR 


13, R2 


RX 


BC 


11,D2(X2,B2) 


RR 


BCR 


11, R2 


RX 


BC 


7,D2(X2,B2) 


RR 


BCR 


7,R2 


RX 


BC 


8,D2(X2,B2) 


RR 


BCR 


8,R2 


RX 


BC 


14,D2(X2,B2) 


RR 


BCR. 


14, R2 



RX 


BC 


1,D2(X2,B2) 


RR 


BCR 


1,R2 


RX 


BC 


4,D2(X2,B2) 


RR 


BCR 


4,R2 


RX 


BC 


8,D2(X2,B2) 


RR 


BCR 


8,R2 


RX 


BC 


14,D2(X2,B2) 


RR 


BCR 


14, R2 


RX 


BC 


11,D2(X2,B2) 


RR 


BCR 


11, R2 


RX 


BC 


7,D2(X2,B2) 


RR 


BCR 


7,R2 



D2=displacement,X2=index register ,B2=base register ,R2=register containing 
branch address 
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D1I — RELOCATION HANELING 



Purpose 



You use the relocation instructions 
in connnection with the relocate 
feature of IBW System/370 . 



Operations Performed 



The relocation instructions allow 
you to perforir the operations listed 
in the figure to the right. However, 
these instructions are privileged 
instructions, and you can use them 
only when the CPU is in the 
supervisor state, but not when it 
is in the problem state. 



Relocation 
Operations 


Mnemonic Operation 
Code 


Load Real Address 


LRA 


Purge Translation 
Lookaside Buffer 


PTLB 


Reset Reference Bit 


RRB 


Set Clock Comparator 


SCKC 


Store Clock Comparator 


STCKC 


Set CPU Timer 


SPT 


Store CPU Timer 


STPT 


Store and AND System 
Mask 


STNSM 


Store and OR System 
Mask 


STOSM 






s \^-ip / 
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D2 - Alignment 



Purpose 



Alignment 



The assembler automatically aligns the object code of all 
machine instructions on halfword boundaries. For execution 
of the IBM System/370 machines, the constants and areas 
do not have to lie on specific boundaries to be addressed 
by the machine instructions. 

However, if the assembler option ALIGN is set, you can 
cause the assembler to align constants and areas; for 
example, on fullword boundaries. This allows faster 
execution of the fullwcrd machine instructions. 

If the NOALIGN option is set, you do not need to align 
constants and areas. They will be assembled at the next 
available byte, which allows you to save space (no bytes 
are skipped for alignment) . 



c 
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Specifications 



MACHINE INSTRUCTIONS ; When the 
assembler aligns machine instructions 
on halfword boundaries, it sets 
any bytes skipped to zero. 

CONSTANTS AND AREAS : One of the 
assembler options that can be set 
in the job control language (that 
initiates execution cf the assembler 
program) concerns the alignment 
of constants and areas; it can 
be specified as ALIGN or NOALIGN. 

If ALIGN is specified, the following 
applies: 

• The assembler aligns constants 
and areas on the boundaries implicit 
in their type, if no length 
specification is supplied. 

• The assembler checks all 
expressions that represent storage 
addresses to ensure that they are 
aligned on the boundaries required 
by the instructions. If they are 
not, the assembler issues a warning 
message. 

If NCALIGN is specified, the 
following applies: 

• The assembler dees not align 
constants and areas on special 
boundaries, even if the length 
specification is emitted. Note 
that the CCW instruction, however, 
always causes the alignment of the 
channel command word on a doubleword 
boundary. 

• The assembler does not check 
storage addresses for boundary 
alignment. 



NOTE 1: The assembler always forces 
alignment if a duplication factor 
of is specified in a constant 
or area without a length modifier 
(for an example, see G3N) . Alignment 
occurs when either ALIGN or NOALIGN 
is set. 



Source Statements 



Object Code 



Ml J 



ALGN 
Specified 

3, ARE A 



AREA DS F 



CONST DC F'200' 



NOALGN 
Specified J 

3, AREA 



AREA DS F 

DS FL4 



A 3,C0NSTT v * 



o 


Half Word 
Boundary 




■' : ' : ck 






00 


58 30 xxxx . 




AREA 


c, 




5A 30 xxxx 



D 



CONST 




Full Word 
Boundary 



xxxxxxxx 



O0O0OOC8 



^.y 



^» 



3,CONST^ ^* 



Half Word 
Boundary 



58 30 xxxx 



AREA 



D 



5A 3 xxxx 



CONST 



/\ 



Can be on any 
boundary 



Equiv. 



CONST DC F'200' 

DC FL4'200' 



c 



xxxxxxxx 



D 



00O0OOC8 



Equiv. 
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NOTE 2: When NOALIGN is specified, 
the CKOF assembler instruction can 
be used to ensure the correct 
alignment of data referred to by 
the privileged instructions that 
require specific boundary alignment, 
The mnemonic operation codes for 
these instructions are listed in 
the figure to the right. 



Mnemonic Operation Codes 
for Privileged Operations 



LPSW 

ISK 

SSK 

LCTL 

SCK 

STIDP 

STCTL 



Meaning 



Load program status word. 

Insert Storage Key. 

Set Storage Key. 

Load Control registers. 

Set Clock. 

Store CPU Identification 

Store Control registers. 



(Diagnose - not handled by assembler) 



€ 



%$ 
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D3 - Statement Formats 



Machine instructions are assembled 
into object code according to one 
of the six formats given in the 
figure to the right. 

When you code machine instructions 
you use symbolic formats that 
correspond to the actual machine 
language formats. Within each basic 
format, you can also cede variations 
of the symbolic representation 
(Examples of coded machine 
instructions, divided into groups 
according to the six basic formats, 
are illustrated in E6 below) . 

The assembler converts only the 
operation code and the operand 
entries of the assembler language 
statement into object code. The 
assembler assigns tc the symbol 
you code as a name entry the value 
of th ^ address of the leftmost 
byte of the assembled instruction. 
When you use this same symbol in 
the operand of an assembler language 
statement, the assembler uses this 
address value in converting the 
symbolic operand intc its object 
code form. The length attribute 
assigned to the syrrbel depends on 
the basic machine language format 
of the instruction in which the 
symbol appears as a name entry 
(for details on the length attribute 
see C4C) . 

A remarks entry is net converted 
into object code. 



Format 



RR 
RX 
RS 
SI 
S 
SS 



■ %m 



Length of Object Code 
Reguired for the Assembled 
Instruction in Bytes 



(L'LABEL=4) 



Example: 

Assembler Language Statement 

LABEL L 4,256(5,10) 

JO/ 




/■""> 



RX Format 



Operation Register Storage 

Code Operand Operand 



4 bytes 



Object Code 
(machine language) ot 
Assembled Instruction 
in Hex 



'ly 



78 



54 - Mnemonic Operation Codes 



Purpose 



|'^"\ 
^^y'' 



© 



You irust specify an cperaticn code 
for each machine instruction 
statement. The irneircnic cperaticn 
code indicates the type of cperaticn 
to he perfcrired; fcr example, "A" 
indicates the "addition" cperaticn. 
Appendix IV contains a complete 
list of mnemonic operation codes 
and the fcrirats of the corresponding 
machine instructions. 

Specifications 

The general format of the machine 
instruction cperaticn cede is shown 
in the figure to the right. 

The verb irust always be present. 
It usually consists of one cr two 
characters and specifies the 
operation to be performed. The 
other iteirs in the operation code 
are not always present. They 
include: 

• Tne modifier which further defines 
the cperaticn 

• The type qualifier , which 
indicates the type of data used 

by the instruction in its operation, 
and 

• Tj3€ fcrmat qualifier , R cr I, 
which indicates that an RR cr SI 
machine instruction format is 
assembled . 



VERB [MODIFIER] [dATA 


type] (machine format] 


Examples : 






( IA 

* 

' -iMVC , " 4 ■: 


3yA3U5A 




o 
o 


Al 


j 




2,FLTSHRT 






logical 




WB'. 


!:■'?■*•« 




binary 




m 


re 






charactei 






ii 


] P 






normalized short 
floating-point 


fcD^ 




' *R ' 


normalized long 
floating-point 






WM 




RR 










o 


mm 




t#4..'«"=- ' ' 






mi •# • 


.-. ■m*t»*x'MaL 9 






i 


SI 









Section D: Machine Instructions 7 9 



D5 - Operand Entries 



O 



Purpose 



You trust specify cne cr mere operands 
in each machine instruction statement 
to provide the data cr the location 
of the data upon which the machine 
operation is to be performed. The 
operand entries consist of cne cr 
more fields cr subfields depending 
on the format of the instruction 
teing ceded. They can specify a 
register, an address, a length, 
and iirmediate data. 

You can code an operand entry either 
with symbols cr with self-defining 
terms. You can omit length fields 
or sutfields, which the assembler 
will compute for you from the ether 
operand entries. 



General Specifications for Coding 
Operand Entries 



The rules for coding operand entries 
are as fellows: 

^P A comma must separate operands. 

^P Parentheses must enclcse subfields. 

OA coirira must separate subfields 
enclosed in parentheses. 

If a subfield is emitted because 
it is in implicit in a symbolic 
address , the parentheses that would 

^fchave enclosed the sufcf ield must 

^^fce emitted. 



LM 
MVI 

MVC 

MVC 

MVI 

MVI 


© 

4, 8/SAVE5 
4 (12),C'F' 

> 

TO (80), FROM 

© 

(80,8), 240(8) 

4(12),C'F' 
KEY, C 'F* 

/ 




Implicit 
Address 
See D5B 











-tV 



80 



f\ 



e 



o 



If twc sutfields are enclosed in 
parentheses and separated fcy commas, 
the fcllcwirg applies: 

If both sufcfields are omitted because 
they are implicit in a symbolic 
entry, the separating comma and 
the parentheses that would have 
been needed must also ke omitted. 

If the first subfield is emitted, 
the comma that separates it froir 
the second subfield irust be written 
as well as the enclosing parentheses. 

If the secend subfield is omitted, 
the comma that separates it from 
the first subfield must be omitted , 
however, the enclosing parentheses 
must te written. 

KOTE: Elanks must not appear within 
the operand field, except as part 
of a character self-defining terir 
or in the specification cf a 
character literal. 



L 
L 

L 
L 

MVC 
MVC 

MVC 

MVC 

MVC 




2,FIELU. 



2,48(4,5) 



Implicit 
Address 
See D5B 



,r 



2,48(',5) 



Index Register 
is omitted 



32( 



,10) ,40(1 



0) 



32(8,10) ,40(10) 



32(16,6) ,48(6) 
TO (16) ,FROM 



Length 
Specification 
is omitted 



Base Register 
implicit in symbolic 
address TO 



32(C . ' ,5) ,=CL64'A,B' 



i 



e 
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E5A — REGISTERS 



VI J 



Purpose and Usage 



You can specify a register in an 
operand for use as an arithmetic 
accumulator, a base register, an 
index register, and as a general 
depository for data to which you 
wish to refer over and over. 

You must be careful when specifying 
a register whose contents have been 
affected by the execution of another 
machine instruction, the control 
program, or an IEM-supplied system 
macro instruction. 

For some machine instructions you 
are limited in which registers you 
can specify in an operand. 



Specifications 



The expressions used to specify 
registers must have absolute values; 
in general, registers through 
15 can be specified for machine 
instructions. However, the following 
restrictions on register usage 
apply; 

1. The floating-point registers 
(0, 2, 4, or 6) must be specified 

for floating-point instructions : 

2. The even numbered registers (0, 
2, 4, 6, 8, 10, 12, 14) must be 
specified for the following groups 
of instructions: 



© 



a. 



The double-shift instructions 



b. The fullword multiply and 
divide instructions 

c. The move long and compare 
logical long instructions. 

3. The floating-point registers 
and 4 must be specified for the 
instructions that use extended 
floating-point data : 

AXR, SXR, LRBR, MXR, MXDR, MXE. 

NOTE: The assembler checks the 
registers specified in the 
instruction statements of the above 
groups. If the specified register 
does not comply with the stated 
restrictions, the assembler issues 
a diagnostic message and does not 
assemble the instruction. 









Registers 


Operation Code 


Register Operand 


Examples: 


L 


3, AREA 




4> FLTAREA 




SLDA 


4,1 


© 


SRDA 


Il2 




SLDL 


■tP 




SRDL 


12 j! 3 




M 


6 ? MULTIP 


© 
© 


D 
( MVCL 


|j|j DIVIDER 




6,8 


Both register operands 








must be even-numbered 






I CLCL 


£• ft 


• 


AXR 


0,4 



Wy 
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REGISTER USAGE BY MACHINE 
INSTRUCTIONS ; Registers that are 
not explicitly coded in the symbolic 
assembler language representation 
of machine instructions, but are 
nevertheless used by the assembled 
machine instructions, are divided 
into two categories: 

1- The base registers that are 
implicit in the symbolic addresses 
specified. These implicit addresses 
are described in detail in D5B. 
The registers can be identified 
by examining the object cede of 
the assembled machine instruction 
or the USING instruction Is) that 
assigns base registers for the 
source module. 

2. The registers that are used by 
machine instructions in their 
operations, but do not appear even 
in the assembled object cede. They 
are as follows: 

a. For the double shift and 
fullword multiply and divide 
instructions, the odd- numbered 
register whose number is one 
greater than the even- numbered 
register specified as the first 
operand. 

b. For the Move Long and Compare 
Logical Long instructions, the 
odd-numbered registers whose 
number is one greater than the 
even numbered registers specified 
in the two operands. 

c. For the Branch on Index High 
(BXH) and the Branch on Index 

Low or Equal (EXLE) instructions; 
if the register specified for 
the second operand is an even- 
numbered register, the next 
higher odd-numbered register 
is used to contain the value 
to be used for comparison. 

d. For the Translate and Test 
(TRT) instruction, registers 

1 and 2 are also used. 

e. For the Load Multiple (LM) 
and Store Multiple (STM) 
instructions, the registers that 
lie between the registers 
specified in the first two 
operands . 

REGISTER USAGE BY SYSTEM : The 
control program of the IEM System/370 
uses registers 0, 1, 13, 14, and 
15. 



Source Module 

START 
BALR 12,0 
USING *,12 Q 



Implicit 
Address 



3, FIELD 



Object Code 
in Hex 



58 


3 | 


C 


XXX 



Register 5 
is also used 



M 



MVCL 



4, TWO 



4,6 



| 5C | 4 | |C|xxx 



j OE j 4 1 6 



Register 5 and 7 
are also used 



BXH 3,4,ADRESS 



86 


3 | 4 


C 


XXX 



Register 5 
is also used 



TRT ARGUMENT (10), TABLE 



o 



Registers 1 and 2 
are also used 



LM 



3 ,7, AREA 



Registers 4,5, and 
6 are also used 




|DD|09|C|xxx|C|xxx] 



98 3 7 C xxx 
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D5B — ADDRESSES 



Purpose and Definition 



You can code a symbol in the name 
field of a machine instruction 
statement to represent the address 
of that instruction. Ycu can then 
refer to the symbol in the operands 
of other machine instruction 
statements. The object code for 
the IBM Systeir/370 requires that 
all addresses be assembled in a 
numeric base- displacement format. 
This format allows you to specify 
addresses that are relocatable or 
absolute. 

You must not confuse the concept 
of relocatability with the actual 
addresses that are coded as 
relocatable, nor with the format 
of the addresses that are assembled. 



DEFINING SYMBOLIC ADDRESSES : You 
define symbols to represent either 
relocatable or absolute addresses. 
You can define relocatable addresses 
in two ways : 

By using a symbol as the label in 
the name field of an assembler 
language statement or 

By equating a symbol to a relocatable 
expression . 

You can define absolute addresses 
(or values) by equating a symbol 
to an absolute expression . 

REFERRING TC ADDRESSES ; You can 
refer to relocatable and absolute 
addresses in the operands of machine 
instruction statements. Such address 
references are also called addresses 
in this manual. The two ways of 
coding addresses are: 

Implicitly : that is, in a form 
that the assembler must first convert 
into an explicit base-displacement 
form before it can be assembled 
into object cede. 

Explicitly: that is, in a form 
that can be directly assembled into 
object code. 



Symbolic 
Addresses 
(Defined) 




Address 
References 


O AREA 


DC 


3F'370' 




A FULLWORD 


EQU 


ARBA+4 




A LOADF 


L 


3, AREA -A 


Relocatable 




L 
L 


4, FULLWORD 

© 


Addresses 




B 


u^O \ 




Q ABSADDR . 


EQU 

• 


IQQ&i 






LA 
LA 
LA 


5 AJBSADDft 

o 


Absolute 
Addresses 



VjT 
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Relocatability of Addresses 



'^f*V 



s 

o 



Addresses in the base-displacement 
form are relocatable, because: 

• Each relocatable address is 
assembled as a displacement from 

a base address and a base register . 

• The base register contains the 

fcag? gflflyess. 

• If the object module assembled 
from your source module is relocated, 
only the contents of the base 
register need reflect this 
relocation. This means that the 
location in virtual storage of your 
base has changed and that ycur base 
register must contain this new base 
address. 

• Your addresses have been assembled 
as relative to the base address; 
therefore, the sum of the 
displacement and the contents of 

the base register will point to 

the correct address after relocation. 

NOTE: Absolute addresses are also 
assembled in the base-displacement 
form, but always indicate a fixed 
location in virtual storage. This 
means that the contents of the base 
register must always be a fixed 
absolute address value regardless 
of relocation. 



Source Module 



START 
Base Addres s BALR 12 , 

USING *,12 



Object Code 
in Hex 
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Specifications 



MACHINE OB OBJECT COCE FORMAT : All addresses assembled 
into the object cede of the IBM System/370 machine 
instructions have the format given in the figure below. 



Addresses 



Format 


Coded or Symbolic 
Representation of 
Explicit Addresses 


Object Code 
Representation 
of Addresses 


RS 
SI 
SS 
RX 

S 

R1 ant 
12 

L 


D2(B2) 
D1(B1) 

D1(,B1) ,D2(B2) 
D2(X2,B2) 

D1(B11 

i R3 represent registers 

represents an immediate vs 
represents a length value 




8 bits 

Operation 

Code 


4 bits 


4 bits 


4 bits 
Base 
Reg- 
ister 


12 bits 
Displacement 


4 bits 
Base 
Reg- 
ister 


12 bits 
Displacement 




ilue 








f 


JK 


I 

f 


^K 




OPCODE; R1 I R3 B2 D2 




OP CODE; 12 


Bl | Dl 




OPCODEJ L J Bl I Dl 


| B2 


D2 








OPCODE; R1 J X2 


B2 


D2 


i/o 


( 






I 
i 




Index 
Register 




OP CODE 


Bl 


Dl 













Vy 



The addresses represented have a value which is the sum 
of: 



^m • A displacement and 

^% • The contents of a base register . 



NOTE: In RX instructions, the address represented has 
a value which is the sum of a displacement, the contents 
of a base register, and the contents of an index register . 



86 






s 



c • 



S 



Implicit Address 

An implicit address is specified 
by coding one expression. The 
expression can be relocatable or 
absolute . The assembler converts 
all implicit addresses into their 
base-displacement form before it 
assembles them into object code. 
The assembler converts implicit 
addresses into explicit addresses 
only if a USING instruction has 
been specified. The USING 
instruction assigns both a base 
address, from which the assembler 
computes displacements, and a base 
register, to contain the base 
address. The base register must 
be loaded with the correct base 
address at execution time. For 
details on how the USING instruction 
is used when establishing 
addressability, thus allowing 
implicit references, see F1. 



Explicit Address 

An explicit address is specified 
by coding two absolute expressions 
as follows: 

The first is an absolute expression 
for the displacement , whose value 
must lie in the range through 
4095 (4095 is the maximum value 
that can be represented by the 12 
binary bits available for the 
displacement in the object code) . 

The second (enclosed in parentheses) 
is an absolute expression for the 
base register , whose value must 
lie in the range through 15. 

If the base register contains a 
value that changes when the program 
is relocated, the assembled address 
is relocatable. If the base register 
contains a fixed absolute value 
that is unaffected by program 
relocation, the assembled address 
is absolute. 

NOTES (for implicit and explicit 
addresses) : 

1. An explicit base register 
designation must not accompany an 
implicit address. 

2. However, in RX instructions an 
index register can be coded with 

an implicit address as well as with 
an explicit address. 

3. When two addresses are required, 
one address can be coded as an 
explicit address and the other as 
an implicit address . 



Source Module 




Object Code 
in Hex 


START 
BALR 12,0 
USING *,12 

L 3, AREA 
AREA DS F 

f 

LA 4,1000 
END 




" o 


!58|3|0|C|xxx| 


Base Register 




Displacement 


o 

41 1 4 | | |3ES| 

/ W 




Always used as 
base register for 
absolute address 
between and 
4095 


Displacement 















Source Statement 



Object Code 
in Hex 



LA 4,X'400' (,10) 



|41 1 4 1 f AT400 




58 3 4 



C xxx 



< 



158 | 3 |4 1C ilOOi 



MVC 



A * - , 

0.(80,10) , FIELD 1D2I4 F 1 A 1 000 lc I xxx] 
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D5C — LENGTHS (^ J 

Purpose 

You can specify the length field in an SS-type instruction. 
This allows you to indicate explicitly the number of bytes 
of data at a virtual storage location that is to be used 
by the instruction. However, you can omit the length 
specification, because the assembler computes the numfcer 
of bytes of data to be used from the expression that 
represents the address of the data. 

Specifications 

IMPLICIT LENGTH ; When a length subfield is omitted from 
an SS-type machine instruction an implicit length is 
assembled into the object code of the instruction. The 
implicit length is either of the following: 

1. For an implicit address (see D5B above) , it is the 

O length attribute of the first or only term in the expression 
representing the implicit address . 

2. For an explicit address (see D5B above) , it is the 
length attribute of the first or only term in the expression 
that represents the displacement. 

For details on the length attribute of symbols and other v 

terms see C4C. : 

EXPLICIT LENGTH ; When a length subfield is specified in 
an SS-type machine instruction, the explicit length thus 
defined always overrides the implicit length. 

NOTES: 

1. An implicit or explicit length is the effective length. 
The length value assembled is always one less than the 
effective length. If an assembled length value of is 
desired, an explicit length of or 1 can be specified. 

2. In the SS instructions requiring one length value, the 
allowable range for explicit lengths is through 256. 
In the SS instructions requiring two length values, the 
allowable range for explicit lengths is through 16. 



O 



w 
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Lengths 



Assembler 

Language 

Statement 


Length Attribute 
of term (symbols) 


Object Code 
in Hex 

L* Length Value 

A 


implicit Lengths 
MVC TO, FROM 

o 

MVC TO+80,FROM 
AP AREA, TWO 

o 

MVC 0(, 10) ,80(10) 


L'TO = SO 

L'TO = 10 
L'AREA = S 


T Address 

L TO FROM 




D2 


4F 


XXXX 


XXXX 




L 




D2 


4F| xxxx | xxxx 




L1 L2 




L ' TWO = 14 

i 


FA 7 3 xxxx xxxx 


i 






a' 
i 


L 




| D2|00 A000 


A050 












L 




MVC FROM-TO(, 10) ,80(10) L' FROM =14.0 


D2 


EF 


A0A0 


A050 






i 


* 












Explicit Lengths 


© 

L'TO = 8 

o 

1 

A 




MVC TO (160), FROM 
MVC 0(80,10) ,80(10) 


Address 

TO FROM 




| D2 9F xxxx xxxx 




L 


D2 4F A000 A050| 








1 

CLC 0(1,10) ,256(10) 


o 

1 
A 


♦ 




D5 00|A000 A100| 






1 

CLC 0(0,10) ,256(10) 


l 


▼ 




| D5|00|AOOO|A100| 


TO DS CL80 
FROM DS CL24 
AREA DS PL8 
TWO DC PL4 ' 2 ' 
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D5D ~ IMMEDIATE CATA 



Purpose 

In addition to addresses, registers, and lengths, some 
machine instruction operands require immediate data. Such 
data is assembled directly into the object code of the 
machine instructions. You use immediate data to specify 
the bit patterns for masks or other absolute values you 
need. 

You should be careful to specify immediate data only where 
it is required. Co not confuse it with address references 
to constants and areas cr with any literals you specify 
as the operands of machine instruction (for a comparison 
between constants, literals, and immediate data, see C5) . 



Specifications 

Immediate data must be specified a-s absolute expressions 
whose range of values depends on the machine instruction 
-^ for which the data is required. The immediate data is -^ 
^p assembled into its 4 -bit or 8-bit binary representation ^p 
according to the figure on the opposite page. 



^k_ 
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Immed. Data 



o 



\jF 



Machine Instructions 
in which immediate 
data is required 
(Op codes in 
Appendix IV) 



SRP 



(SS) 



All BCR (RR) 
All BC (RX) 



ICM 

STCM 

CLM 



NI 
CLI 

XI 
MVI 

01 

TM 
RDD 
WRD 



SVC 



(rs; 



(si: 



(RR) 



Range of Values 
allowed for 
immediate data 



through 9 



through 15 
through 15 



through 15 



through 255 



through 255 



Examples 



Object Code 
in Hex 



SRP A,B, 3 



C~fy 



FO 


7 


3 


xxxx 


xxxx 




. 




/ \ A 


B 




Length of 
Field A 


Addresses 



BCR 8,3 ^ 




07 


8 | 3 












BC 11, AAA 


|47|B 





xxxx 



AAA 
Address 



STCM 3,X'F',BBB | BE 1 3 \ F 1 xxxx 



BBB 
Address 



Address 
SLOT 



CLI SL0T,C'A' 95 Cl 



© 

TM KEY,X*7F' j 91 | 7F 



xxxx 



xxxx 



Address 
KEY 



SVC 128 



OA 



80 
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D6 - Examples of Coded Machine Instructions 



i. 



The examples in this subsection 
are grouped according to irachine 
instruction format. They illustrate 
the various ways in which ycu can 
code the operands of machine 
instructions. Both syrrbolic and 
numeric representation of fields 
and subfields are shewn in the 
examples. You must therefore assuire 
that all symbols used are defined 
elsewhere in the same source module. 

The object cede assembled from at 
least one coded statement per group 
is also included. A complete summary 
of machine instruction formats with 
the ceded assembler language variants 
can be found in Appendix III and 
IV. 



BR Format 



You use the instructions with the 
RR format mainly to move data between 
registers. The operand fields must 
thus designate registers, with the 
following exceptions: 

In BCP branching instructions when 
a 4-bit branching mask replaces 
the first register specification 

In SVC instructions, where an 
immediate value (between and 255) 
replaces both registers. 

NOTE: Symbols used in RR 
instructions are assumed to be 
equated to absolute values between 
and 15. 



Name 



ALPHA1 
ALP HA 2 

GAMMA1 
DELTA 1 
DELTA2 



Operation 



LR 
LR 

BCR 
SVC 
SVC 



Operand 



1,2 

INDEX ,REG2 

O 

08,12 
200® 

TEK 



Assembly Examples: 
Assembler Language Statement 



Object Code of 

Machine Instruction 

in Hex 



ALPHA1 LR 1,2 




RR Format 



1 8 


1 


2 


Operation 
Code 


Regi 
Opei 


ster 
-ands 



2 bytes 






^U*' 
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RX Format 



You use the instructions with the 
RX format mainly to move data between 
a register and virtual storage. 
By adjusting the contents of the 
index register in the RX-instructions 
you can change the location in 
virtual storage being addressed. 
The operand fields must therefore 
designate registers, including index 
registers, and virtual storage 
addresses, with the following 
exception: 

In BC branching instructions a 4- 
hit branching mask , with a value 
between and 15, replaces the first 
register specification. 

NOTES : 

1. Symbols used tc represent 
registers are assumed to be equated 
to absolute values between and 
15. 

2. Symbols used to represent implicit 
addresses can be either relocatable 
or absolute. 

3. Symbols used to represent 
displacements in explicit addresses 
are assumed to be equated to absolute 
values between and 4095. 



Name 

ALPHA1 
ALPHA2 

BETA1 
BETA2 

GAMMA1 
GAMMA2 

DELTA1 

LAMDA1 
LAMDA2 



Operation 

L 
L 

L 
L 

L 
L 



BC 
BC 



Operand 

1,200(4,10) 

REG1 , 2 ( INDEX , BASE ) 



2, 200 (.10) 



REG2,DISPL(7BASE) 
3, IMPLICIT -jQ 



3 IMPLICIT (INDEX) 
4, 



No Indexing 




Literal Specification 
SeeC5 



§| t DISPL(,BASE) 
I* ADDRESS 



Assembly Examples: 
Assembler Language Statement 



ALPHA1 L 1,200(4,10? 



Object Code of 

Machine Instruction 

in Hex 




RX Format 




5 8 


1 


4 


A 


C 8 


Operation 
Code 


R< 
R1 


sgista 

X 


Base 


Displacement 
from Base 


5 8 


2 


4 


X 


XXX 



GAMMA1 L 2, IMPLICIT (4) 
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RS Format 



You use the instructions with the 
RS format mainly to move data between 
one or more registers and virtual 
storage or to compare data in one 
or more registers (see the BXH and 
BXLE operations in Appendix IV) . 

In the Insert Characters under Mask 
(ICM) and the Store Characters Under 
Mask (STCM) instructions, when a 
4-bit mask , with a value between 
and 15, replaces the second 
register specification. 

NOTES : 

1. Symbols used to represent 
registers are assumed to be equated 
to absolute values between and 
15. 

2. Symbols used to represent implicit 
addresses can be either relocatable 
or absolute. 

3. Symbols used to represent 
displacements in explicit addresses 
are assumed to be equated to absolute 
values between and 4095. 



Name 



ALPHA1 


LM 


ALPHA2 


LM 


BETA1 


STM 


BETA2 


STM 


GAMMA 1 


SLL 


GAMMA 2 


SLL 


DELTA1 


ICM 


DELTA2 


ICM 



Operation 



Operand 

4,6,20(12) 

REG4 , REG6 , 2 ( BASE) 

^©-^ 

4, 6, AREA© 
4,6,DISPL(BASE) 

o 

2,15 
2,0(15) 

3,\JC»i:%1024(10) 

REG3 ,MASK, IMPLICIT© 



Assembly Examples: 
Assembler Language Statement 



Object Code of 

Machine Instruction 

In Hex 



ALPHA1 LM 4,6,20(12) 




RS Format 



9 8 


4 


6 


C 


14 


Operation 
Code 

1 


F 
R1 


egistc 

R3 
or 

M3 


rs 

Base 


Displacement 
from Base 


B F 


3 


E 


A 


4 




DELTA1 ICM 3, X'E' ,1024(10) 
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SI Format 



You use the instructions with the 
SI format mainly to move immediate 
data into virtual storage. The 
operand fields must therefore 
designate iirmediate data and virtual 
storage addresses, with the following 
exception: 

An immediate field is not needed 
in the statements whose operation 
codes are: LPSW, SSW., TS, TCH # and 
TIO. 

NOTES: 

1. Symbols used to represent 
immediate data are assumed to be 
equated to absolute values between 
and 255. 

2. Symbols used to represent implicit 
addresses can be either relocatable 
or absolute . 

3. Symbols used to represent 
displacements in explicit addresses 
are assumed to be equated to absolute 
values between and 4095. 



Name 



ALPHA1 
ALPHA 2 

BETA1 
BETA2 

I GAMMA 1 
GAMMA2 



Operation 



CLI 
CLI 

CLI 
CLI 

LPSW 
LPSW 



Operand 



40(9) ,X'40' 



0DISPL4O (NINE) ,H^X40 



^^HEMPLICIT, 

Nkey^'e' 

0(9) 

NEWS TATE ^ 



Assembly Examples: 
Assembler Language Statement 



ALPHA1 CLI 40 (9), X' 40' 



Object Code of 
Machine Instruction 
In Hex 




SI Format 



9 5 


4 


9 


2 8 


Operation 
Code 


Immediate 
Data 


at* 

CO fl> 

cc 


Displacement 
from Base 
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S Format 



You use the instructions with the 
S format to perform I/O and other 
system operations and not to move 
data in virtual storage. 

The operation codes for these 
instructions are given in the figure 
to the right. They are assembled 
into two bytes. 





Mnemonic 
Operation 
Codes 


Assembled 
Operation 
Code in 
Hex 


Description 




SIO 


9C00 


Start I/O 




SIOF 


9C01 


Start I/O fast 
release 




HIO 


9E00 


Halt I/O 




HDV 


9E01 


Halt Device 




STIDP 


B202 


Store CPU ID 




STIDC 


B203 


Store Channel 
ID 




SCK 


B204 


Set Clock 




STCK 


B205 


Store Clock 




SCKC 


B206 


Set Clock Comparator 




STCKC 


B207 


Store Clock Comparator 




SPT 


B208 


Set CPU Timer 




STPT 


B209 


Store CPU Timer 




PTLB 


B20D 


Purge Translation 
Lookaside Buffer 




RRB 


B213 


Reset Reference Bit 






Vy 
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SS Format 



c 



O 



You use the instructions with the 
SS format mainly to move data between 
two virtual storage locations. 
The operand fields and subfields 
must therefore designate virtual 
storage addresses and the explicit 
data lengths you wish to include. , 
However, note the following 
exception: 

In the Shift and Round Cecimal (SRP) 
instruction a U-bit immediate data 
field, with a value between and 
9, is specified as a third operand. 

NOTES: 

1. Symbols used to represent base 
registers in explicit addresses 

are assumed to be equated to absolute 
values between and 15. 

2. Symbols used to represent explicit 
lengths are assumed to be equated 

to absolute values between and 
256 for SS instructions with one 
length specification and between 
and 16 for SS instructions with 
two length specifications. 

3. Symbols used to represent im plicit 
addresses can be either relocatable 
or absolute. 

4. Symbols used to represent 
displacements in explicit addresses 
are assumed to be equated to absolute 
values between and 4095. 



Name 



ALPHA1 
ALPHA2 

ALPHA3 
ALPHA4 
ALP HA 5 

BETA1 
BETA 2 
BETA3 



Operation 



AP 
AP 

AP 
AP 
AP 

MVC 
MVC 
MVC 
SRP 



Operand 



40(9,8) ,30(6,7) 
40(NINE,BASE8) , 30 (SIX ,BASE7) 

F IELD 1 , F IELD2__^^ 
AREA(9) ,AREA2(6) 
DISP40(,8) ,DISP30(,7) 

0(80, 8), 0(7) 
DISP0(,8) ,DISP0(7) 
TO, FROM 

o 

FIELDl,X'8',i ; 



Assembly Examples: 
Assembler Language Statement 



Object Code of 

Machine Instruction 

in Hex 



ALPHA1 AP 40(9,8) ,30(6,7) 




SS Format 



F A 


8 


5 


8 


2 8 


7 


1 E 


Operation 
Code 


Lengths 
LI L2 

L 


Base 

1 


Displacement 
from Base 1 


Base 
2 


Displacement 
from Base 2 


D 2 


4 F 


8 





7 







BETA1 MVC 0(80, 8), 0(7) 
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SECTION E: PROGRAM SECTIONING 

SECTION F: ADDRESSING 

SECTION G: SYMBOL AND DATA DEFINITION 

SECTION H: CONTROLLING THE ASSEMBLER PROGRAM 
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Section E: Program Sectioning 



This section explains how you can 
subdivide a large prcgrair into 
smaller parts that are easier to 
understand and maintain. It also 
explains how you can divide these 
smaller parts into convenient 
sections: for example, one section 
to contain your executable 
instructions and another section * 
to contain your data constants and 
areas. 

You should consider two different 
subdivisions when writing an 
assembler language prograir: 

1. The source module 

2. The control section. 

You can divide a program into two 
or more source modules. Each source 
module is assembled into a separate 
i object module . The object modules 
can then be combined into load 
modules to form an executable 
program. 



You can also divide a source module 

Ointo two or more control sections. 
Each control section is assembled 
as part of an object module. By 
writing the proper linkage edit 

O control statements, you can select 
a complete object module or any ^^ 
individual control section of the ^P 
object module to be linkage edited 
and later loaded as an executable 
program. 

SIZE OF PROGRAM PARTS : If a source 
module becomes so large that its 
logic is not easily comprehensible, 
break it up into smaller modules. 

Unless you have special programming 
reasons, you should write each 
control section so that the resulting 
object code is not larger than 4096 
bytes. This is the largest number 
of bytes that can be covered by 
one base register (for the assignment 
of base registers to control 
sections, see F1A) . 

COMMUNICATION BETWEEN PROGRAM PARTS : 
You must be able to communicate 
between the parts of your program: 
that is, be able to refer to data 
in a different part or be able to 
branch to another cart. 



Source 
Program 


Assembly 
Time 

o e 

Source Object 
Modules Modules 




Program 

Fetch 

Time 

ii • 

H I Executable 
M J Program 


A 
END 


^> 


A 


^ 








B 

END 


O 


B 


^ 










C 
END 


z> 


C 


C# 











Assembly 


Linkage 


Program 


Time 


Edit 


Fetch 




Time 


Time 



Source Control Object 

Modules Sections Modules 



A 


1 




2 






B 


3 


Source 
Program ' 


4 




5 






C 


6 




Executable 
program 
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To communicate between two or more 
source modules, ycu must symbolically 
link them together; symbolic linkage 
is described in F2. 

To communicate between two or more 
control sections within a source 
module, you must establish the 
addressability of each control 
section; establishing addressability 
is described in F1. 



/On 



Source Mod. 



El - The Source Module 



A source module is composed of 
source statements in the assembler 
language. You can include these 
statements in the source module 
in two ways: 

1. You write them on a coding form 
and then enter them as input , for 
example, through a terminal or, 
using punched cards, through a card 
reader. 

2. You specify one cr more COPY 
instructions among the source 
statements being entered. When 
the assembler encounters a COPY 
instruction, it replaces the COPY 
instruction with a predetermined 
set of source statements from a 
library . These statements then 
become a part of the source module. 



The Beginning of a Source Module 



Punched cards 



Library 

iOi 



Terminal 





The 

Assembler 

Program 



OS 

only 



The first statement of a source 
module can be any assembler language 
statement, except MEXIT and MEND, 
that is described in this manual. 
You can initiate the first control 
section of a source module by using 
the START instruction. However, 
you can or must write some source 
statements before the beginning 
of the first control section (for 
a list of these statements see E2E) . 



The End of a Source Module 



The END instruction usually marks 
the end, of a source module . However, 
you can code several END 
instructions. The assembler stops 
assembling when it processes the 
first END instruction. If no END 
instruction is found, the assembler 
will generate one* 





Source Moduli 


i 


A 




' 


START 








V 












END 


OS 
only 


Statements here are 
processed as comments 
statements if the 
LIBMAC option is 
set (seeJ8A) 















\J 
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3 Conditional assembly processing 
determine which of several 

stituted end instructions is to be 
*ed. The conditional assembly 

guage is described in Section L. 



instruction is allowed. 
t&*t Allows tte* I»D 




E1A — THE COFY INSTRUCTION 



COPY 



Purpose 



The CCPY instruction allows you 
to copy predefined source statements 
from a library and include them 
in a source module . Ycu thereby 
avoid : 

1. Writing the same, often- used 
sequence of code over and over 

2. Keypunching and handling the 
punched cards for that code. 



c 



Source Statement 



Source Module 



START 



COPY EQUATES 



END 



fS> 




First Input 
to Assembler 
Program 



START 


Rl 


-VQD 1*1 


R2 


BQO 2.1 


i R3 


tow VI 


" 




■-, ". 


: p««jr*&$$fl« 


■< ■■ 


- ^E« 


* . 




% SBsKu 


- m 




.... * ^ .. J " 




• 




END 




Effective 
Input to 
Assembler 
Program 




Section E: Program Sectioning 103 



Specifications 



The format of the COPY instruction 
statement is shown in the figure 
to the right. 

The symbol in the operand field 
must identify a part of a library 
called: 

A member of a partitioned data 
set 

A book in the source statement 
library 

This member (or beck) contains the 
coded source statements to be copied. 

The source coding that is copied 
into a source module: 

%P • Is inserted immediately after 
the CCPY instruction 

• Is inserted and processed 

©according to the standard instruction 
statement coding format (described 
in B1D) , even if an ICTL instruction 
has been specified 

• Must not contain either an ICTL 
or ISEQ instruction 

^fc • Can contain a COPY instruction . 
Up to 5 levels of nesting of the 
COPY instruction are allowed. 



Dp to 3 levels of nesting are 
allowed. 

• Can contain macro definitions 
(see Section J) . 



If a source macro definition is 
copied into the beginning of a 
source module, both the MACRO and 
MEND statements that delimit the 
definition must be contained in 
the same level of copied code. 

NOTES : 

1. The COPY instruction can also 
be used to copy statements into 
source macro definitions (see J5C) 

2. The rules that govern the 
occurrence of assembler language 
statements in a source module 
also govern the statements copied 
into the source module. 



Name 


Operation 


Operand 


Blank 


COPY 


One ordinary 
Symbol 



,J 



Source Module ffl 



begin 
1 



10 



continue end 

16 71 Columns 



Library 
(Partitioned 
data set) 



COPY MAC1 



MACRO 
ANY 



MEND 



OPEN START 



COPY CODE1 



R0 
Rl 



EQU 
EQU 1 




COPY CODE2 



V 



I» 3 ,AREA 

A 3,FTWO 

ST 3, SUM 

B PAST 

COPY CODE3 




PAST 



4, SUM 



END 



\|4_. ..-W 



I 



i^y 
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E1B — THE END INSTRUCTION 



Purpose 



You use the END instruction to mark 
the end of a source module. It 
indicates to the assembler where 
to stop assembly processing. You 
can also supply an address in the , 
operand field to which control can 
be passed when your program is 
loaded. This is usually the address 
of the first executable instruction 
in a source module. 



f*\ 



O 



Specifications 



The format of the END instruction 
statement is shown in the figure 
to the right. 



If specified, the operand entry 
can be generated by substitution 
into variable symbols. However, 
after substitution, that is, at 
assembly time: 

1. It must be a relocatable 
expression representing an address 
in the source module delimited 

by the END instruction, or 

2. If it contains an external symbol, 
the external symbol must be the 
only term in the expression, or 

the remaining terms in the expression 
must reduce to zero. 

3. It must not be a literal. 




Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


END 


A relocatable 
expression or 
blank 



Source Module A 



A START 

ENTERA BALR 12,0 

USING *,12 

ENTRY ENTERA 



END 



ENTERA 



Source Module B 



START 
BALR 
USING 
EXTRN 



END 




11,0 

*,11 
ENTERA 



ENTERA + (Subexpression) 
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E2 - General Information About Control Sections 



Contrl Sect. 



A control section is the smallest subdivision of a program 
that can be relocated as a unit. The assembled control 
sections contain the object code for machine instructions, 
data constants, and areas. 
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E2A — AT DIFFERENT PROCESSING TIMES 



o 



o 



Consider the concept of a control section at different 
processing times. 

AT CODING TIME; You create a control section when you 
write the instructions it contains. In addition, you 
establish the addressability of each control section within 
the source module, and provide any symbolic linkages between 
control sections that lie in different source modules. 
You also write the linkage editor control statements to 
combine the desired control sections into a load module, 
and to provide an entry point address for the beginning 
of program execution. 

AT ASSEMBLY TIME: The assembler translates the source 
statements in the control section into object code. Each 
source module is assembled into one object module. The 
entire object module and each of the control sections it 
contains is relocatable. 

AT LINKAGE EDITING TIME ; According to linkage editor control 

statements, the linkage editor combines the object code 

of one or more control sections into one load module. 

It also calculates the linkage addresses necessary for 

communication between two or more control sections frcir 

different object modules. In addition, it calculates the 

space needed to accommodate external dummy sections (see f "~A 

E4) . ^ku^ 

AT PROGRAM FETCH TIME; The control program loads the load 
module into virtual storage. All the relocatable addresses 
are converted to fixed locations in storage. 

AT EXECUTION TIME : The control program passes control 

to the load module now in virtual storage and your program 

is executed. 

NOTE: You can specify the relocatable address of the 
starting point for program execution in a linkage editor 
control statement or in the operand field of an END 
statement. 



^ 
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CODING 
TIME 



Source 
Modules 



Section C 








Section B 








Section A 



" \ 
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*■ Section F 






Section E 



ASSEMBLY 
TIME 



LINKAGE 

EDIT 

TIME 



PROGRAM 

FETCH 

TIME 



EXECUTION 
TIME 



Object 
Modules 



Load 
Modules 




I { 



»■ 




I ■ 1 < 





< 







c- 



X'23000' 



First 
Program 




XMOOOO' 



Second 
Program 
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E2B — TYPES 



.J*r 



Executabl e Control Sections 




An executable control section is 
one you initiate by using the START 
or CSECT instructions and is 
assembled into object code. At 
execution time, an executable control 
section contains the binary data 
assembled from your coded 
instructions and constants and is 
therefore executable. 

An executable control section can 
also be initiated as "private code", 
without using the START or CSECT 
instruction (see E2E) . 



Reference Control Sections 



A reference control section is one 
you initiate by using the DSECT, 
COM, or B&H, instruction and is not 
assembled into object code. You 
can use a reference control section 
either to reserve storage areas 
or to describe data to which you 
can refer from executable control 
sections. These reference control 
sections are considered tc be empty 
at assembly time, and the actual 
binary data to which they refer 
is not entered until execution time. 



Assembly Execution 
Time Time 

Source Module Object Module Load Module 








EXEC START 








a» 


EXEC 


\ 






<fc 












REFER COM 


r© ic^ 


i ^ i * 


o 






© 


/ 

Empty of data 
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E2C — LOCATION COUNTER SETTING 






The assembler maintains a separate 
location counter for each control 
section. The location counter 
setting for each control section 
starts at 0. The location values 
assigned to the instructions and 
other data in a control section * 
are therefore relative to the 
location counter setting at the 
beginning of that control section. 

i However, for executable control 

sections , the location values that 
I appear in the listings do not restart 
* at for each subsequent executable 
control section. They carry on 
from the end of the previous control 
section. Your executable control 
sections are usually loaded into 
storage in the order you write them. 
You can therefore match the source 
statements and object code produced 
from them with the contents of a 
dump of your program. 

!pr executable control sections, 
|$j4t location values that appear 
life; the listings always start from 

*j#jr except the control #e#tion 
initiated by a START instruction 

J^l^t, a!.aoh-'iero operand eafciry. 

| For reference control sections , 
the location values that appear 
. in the listings always start from 

Jo. 



Listed Location 
in hex 



( — 204 

W208 A 



Source Module 




END 
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^p You can continue a control section 
that has been discontinued by another 
control section and thereby 
intersperse code sequences from 
^^ different control sections. Note 
^m that the location values that appear 
in the listings for a control 
section, divided into segments, 
follow from the end of one segment 
to the beginning of the subsequent 
segment. 

OS 

poiy The location values listed for the 
Jfrnext control section defined begii? 
drafter the last location value 

assigned to the preceding control 

section* 



Location 
in Hex 








2ocr 



Source Module 



mm 



ST&R2* 



DS 



SUBONE 



CSECT 



MAIK 



V 



CSECT 



END 



/lO-v 



( \ 
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E2D — FIRST CONTROL SECTION - 
SPECIFICATIONS 



The specifications below apply to 
the first executable control section, 
and not to a reference control 
section. 

INSTRUCTIONS THAT ESTABLISH THE 
FIRST CONTROL SECTION : Any 
instruction that affects the location 
counter or uses its current value 
establishes the beginning of the 
first executable control section. 
The instructions that establish 
the first control section are listed 
in the figure to the right. 

The statements copied into a source 
^fc module by a COPY instruction , if 
^^ specified, determine whether or 

not it will initiate the first 

control section. 

OS NOTE: The ESECT, COM, and ftXD 
tarty instructions initiate reference 

control sections and dc net establish 
the first executable control section. 



^r*v 











Any Machine Instruction 

The Following Assembler Instructions: 

CCW 
mu CNOP 

n (copy) 

^ CSECT 
CXD 
DC 

DROP 
DS 
END 
EQU 
LTORG 
ORG 
START 
USING 






\ 




/ 






These instructions are always 
considered a part of the control 
section in which they appear. 















WHAT MUST COME EEFORE THE FIRST 
CONTROL SECTION : The following 
instructions or groups of 
instructions, if specified, must 
appear before the first control 
section, as shown in the figure 
to the right. 

• The ICTL instruction, which, 
if specified, must be the first 
statement in a source module 

m • The 0PSY8 instruction 



• Any source macro definitions 
(see J1B) 

• The COPY instruction, if the 
code to be copied contains only 
OPSYN instructions or complete macro 
definitions. 


















First Contrl Sect. 


Source Module 




ICTL 
OPSYN 


\ 










© 




These instructions or 
macro definitions belong 
to a Source Module, but 
must appear before the 
first control section. 




MACRO 
MACl 

MEND 






MACRO 
MAC 2 

MEND 










/ 




MACRO 
MAC 3 

MEND 










FIRST START 

First control 
section 
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WHAT! CAN CE1ICNALLY COKE EEFOBE 
THE FIRST CONTROL SECTION ; The 
instructions or groups of 
instructions that can optionally 
be specified before the first control 
section are shown in the figure 
to the right. 

Any instructions copied by a COPY 
instruction or generated by the 
processing of a macro instruction 
before the first control section 
must belong exclusively to one of 
the groups of instructions shown 
in the figure to the right. 

NOTES: 

1. The EJECT, ISEQ, PRINT, SPACE, 
or TITLE instructions and comments 
statements must follow the ICTL 
instruction, if specified. However, 
they can precede or appear between 
source macro definitions . The OPSYN 
instruction must (1) follow the 
ICTL instruction, if specified, 

and (2) precede any source macro 
definition specified. 

2. All the other instructions of 
the assembler language must follow 
any source macro definitions 
specified. 

3. All the instructions or groups 

of instructions listed in the figure 
to the right can also appear as 
part of a control section . 



Source Module 




COPY 
DXD 

EJECT 

ENTRY 

EXTRN 

ISEQ 

PRINT 

PUNCH 

REPRO 

SPACE 

TITLE 

WXTRN 



CAN 



Comments Statements 



Common Control Sections 



Dummy Control Sections 



External Dummy Control Sections 



Any Conditional Assembly Instruction 




These instruc- 
tions or groups 
of instructions 
belong to a 
Source 
Module, but 
are not con- 
sidered as part 
of an exe- 
cutable 
control 
section. 
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E2E — THE UNNAMED CONTROL SECTION 

The unnamed control section is an 
executable control section that 
can be initiated in one of the 
following two ways: 

^k 1. By coding a START or CSECT 
instruction without a name entry 

2. By coding any instruction, other, 
than the START or CSECT instruction, 

©that initiates the first executable 
control section . 

The unnamed control section is 
sometimes referred to as private 
code. 

All control sections ought to be 
provided with names so that they 
can be referred to symbolically: 

1. Within a source module 

2. In EXTRN and WXTRN instructions 
and linkage editor control statements 
for linkage between source modules. 

NOTE: Unnamed common control sections 
or dummy control sections can be 
defined if the name entry is omitted 
from a COM or DSECT instruction. 



Only unnamed bn control sections 
initiated by the COM instruction) 
and named dummy control sections 
(initiated by the DSECT instruction) 

■■IJHpliilite^v:«' 



E2F — LITERAL POOLS IN CONTROL 
SECTIONS 



Literals, collected into pools by 
the assembler, are assembled as 
part of the executable control 
section to which the pools belong. 
If a LTORG instruction is specified 
at the end of each control section, 
the literals specified for that 
section will be assembled into the 
pool starting at the LTORG 
instruction. If no LTORG instruction 



Type Code 
Assigned for 
External Symbol 
Dictionary 



Unnamed Control 
Sections in separate 
Source Modules 




PC 



)balr 


12 


,0 


USING 




12 


END 







Notes 



Unnecessary unless 
dictated by specific 
programming pur- 
pose 



Inadvertent and in- 
advisable initiation 
of first control sec- 
tion: instead, precede 
with a named 
START instruction 



PC signifies "private code" 



e 



O 



is specified, a literal pool 
containing all the literals used 
in the entire source module is 
assembled at the end of the first 
control section. This literal pool 

©appears in the listings after the 
END instruction . 

NOTE: If any control section is 
divided into segments, a LTORG 
instruction should be specified 
at the end of each segirent to create 
a separate literal pool for that 
segment. (For a complete discussion 
of the literal pool see H1B.) 



Location 
in hex 



Source Module 






SECT1 START 





• 


L 

y\ A 

7 r LTORG 


3,=F , 222' 
3,=F'32» 


OA0 


U : 


=F , 222 I 
=F , 32' 
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E2G — EXTERNAL SYMBOL DICTIONARY 
ENTRIES 



The assembler keeps a record of 
each control section and prints 
the following information about 
it in an External Symbol Dictionary. 

1. Its symbolic name, if cne is 
specified 

2. Its type code 

3. Its individual identification 

4. Its starting address. 

The figure to the right lists: 

1 . The assembler instructions that 

O define control sections and dummy 
control sections or identify entry ^^ 
and external symbols , ^P 

2. The type code that the assembler 
assigns to the control sections or 
dummy control sections and to the 
entry and external symbols. 

NOTE: The total number of entries 
identifying separate control 
sections, dummy control sections, 
entry symbols, and external symbols 
in the external symbol dictionary 
must not exceed 399. External 
symbols identified in a Q-type 
address constant and specified as the 

O name entry of a DSECT instruction are 
counted twice in determining this 
total . 



Name 
Entry 


Instruction 


Type code en- 
tered into external 
symbol dictionary 


optional 




START 
CSECT 


SD ] if name 

> entry is 

SD j present 






START 

CSECT 

Any instruction that 
initiates the unnamed 
control section 


PC | if name 

/ entry is 

PC J omitted 

PC 


optional 
DOS 


o 


COM 


CM 


optional 




DSECT 


none 


DOS 
mandatary 








OS only 
mandatory 




MB*/ :; ;...;: 


XB 


mandatory 




(external DSE£3?1 


m 




© 


' ENTRY 
EXTRN 


LD 
ER 






DC(V-type ad- 
dress constant) 


ER 






WXTRN 


WX 



,#~^ 

\--^ 



DOS The maximum number of external symbol 
dictionary entries (control sections, 
dummy control sections, and external 
symbols) allowed is 511. The maximum 
allowable number of symix>ls 
identified by the ENTRY instruction - 
is 200 * ... 
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E3 - Defining a Control Section 



You must use the instructions described below to indicate 
to the assembler: 

• Where a control section begins and 

• Which type of control section is being defined. 



E3A — THE START INSTRUCTION 



Purpose 



c 



The START instruction can be used only to initiate the 
first or only executable control section of a source ircdule. 
You should use the START instruction for this purpose, 
because it allows you: 

1. To determine exactly where the first control section 
is to begin; you thereby avoid the accidental initiation 
of the first control section by some other instruction. 

2. To give a symbolic name to the first control section, 
which can then be distinguished from the other control 
sections listed in the external symbol dictionary. 

3. To specify the initial setting of the location counter 
for the first or only control section. 



Specifications 



The START instruction must be the 
first instruction of the first 
executable control section of a 
source module . It must not be 
preceded by any instruction that 
affects the location counter and 
thereby causes the first control 
section to be initiated. 

The format of the START instruction 
statement is given in the figure 
to the right. 









START 


Name 


Operation 


Operand 


Any Symbol 
or blank 


START 


A self-defining 
term, or blank 
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The symbol in the name field, if 
specified, identifies the first 
control section. It must be used 
in the name field of any CSECT 
instruction that indicates the 
continuation of the first control 
section. This symbol represents 
the address of the first byte of 
the 'control section and has a length 
attribute value of 1 . 

The assembler uses the value of 
the self-defining term in the operand 
field, if specified, to set the 
location counter to an initial value 
for the source module. All control 
sections are aligned on a doubleword 
boundary. Therefore, if the value 
specified in the operand is not 
divisible by eight, the assembler 
sets the initial value of the 
location counter to the next higher 
doubleword boundary . If the operand 
entry is omitted, the assembler 
sets the initial value to 0. 



Location In 
Hex 

000000 



Source Module 



O00D0O 



000D04 Q 

000D04 












FIRST 


START 







BREAK 


DS 


F 




iflgK&QNP v 


pat&t •; 






|IUjjl|j^^^8 


lllftltllilllfcjlllttPi 


|j§|j|f 


* 








'< 


FIRST 


CSECT 






CONTINUE 


DS 

END 


F 








vy 



Further Examples: 



001000 A 
001000 B 
000020 C 



© 

000000 



START 


X'lQOQ' 


START 


4096 


START 


30 


START 





iT 



^jf 



118 



Source Module 



c 



The source statements that follow 
the START instruction are assembled 
into the first control section. 
If a CSECT instruction indicates 
the continuation of the first control 
section, the source statements that 
follow this CSECT instruction are 
also assembled into the first control 
section. 

Any instruction that defines a new 
or continued control section marks 
the end of the preceding control 
section or portion of a control 
section. The END instruction marks 
the end of the control section in 
effect. 



E3B — THE CSECT INSTRUCTION 



Purpose 



FIRST 



START 




0^ 



FIRST CSECT 



END 



The CSECT instruction allows you to initiate an executable 
control section or indicate the continuation of an 
executable control section. 



Specifications 



The CSECT instruction can be used anywhere in a source 
module after any source macro definitions that are 
specified. If it is used to initiate the first executable 
control section, it must not be preceded fcy any instruction 
that affects the location counter and thereby causes the 
first control section to be initiated. 



CSECT 



The format of the CSECT instruction 
statement is shown in the figure 
to the right. 



Name 


Operation 


Operand 


Any Symbol 
or blank 


CSECT 


Not required 
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The symbol in the name field, if 
specified, identifies the control 
section. If several CSECT 
instructions within a source module 
have the same symbol in the name 
field, the first occurrence initiates 
the control section and the rest 
indicate the continuation of the 
control section. If the first 
control section is initiated by 
a START instruction, the symbol 
in the name field must be used to 
indicate any continuation of the 
first control section. 

NOTE: A CSECT instruction with 
a blank name field either initiates 
or indicates the continuation of 
the unnamed control section (see 
E2E) . 



The symbol in the name field 
represents the address of the first 
byte of the control section and 
has a length attribute value of 
1. 

The beginning of a control section 
is aligned on a doubleword boundary. 
However, the continuation of a 
control section begins at the next 
available location in that control 
section. 



Source Module 






FIRST START 



o 
o 



©^ 



€► 



SECOND CSECT 



THIRD CSECT 



FIRST CSECT 



FIRST CSECT 



^— THIRD CSECT 



END 



\^J 



The source statements that follow 
a CSECT instruction that either 



initiates or indicates the 
continuation of a control section 
are assembled into the object code 
of the control section identified 
by that CSECT instruction. 

NOTES : 

1 . The end of a control section or 
portion of a control section is 
marked by: 

a. Any instruction that defines a 
new or continued control section 
or 

b. The END instruction. 

DOS 2. The location coaster is reset to 
zero each time the DOS AS assembler 
encounters a CSECT instruction. (The 
figure on the right illustrates 
location counter settings when using 
the OS/VS assembler.) 



Loc in 
Hex 



000 



Source Module 



Object Module 



FIRST START 




END 



o 
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E3C — THE DSECT INSTRUCTION 



Purpose 



You can use the DSECT instruction 
to initiate a dummy control section 
or to indicate its continuation. 



A dummy control section is a 
reference control section that 
allows you to describe the layout 
of data in a storage area without 
actually reserving any virtual 
storage . 



e 



How to Use a Dummy Control Section 



The figure to the right illustrates 
a dummy control section. 

A dummy control section (dummy 
section) allows you to write a 
sequence of assembler language 
statements to describe the layout of 
unformatted data located elsewhere in 
your program. The assembler produces 
no object code for statements in a 
dummy control section and it reserves 
no storage for the dummy section. 
Rather, the dummy section provides a 
symbolic format that is empty of 

Odata. However, the assembler assigns 
location values to the symbols you 
define in a dummy section, relative 
to the beginning of that dummy 
section. 

Therefore, to use a dummy section 
you must: 

^fc • Reserve a storage area for the 
^^ unformatted data 

• Ensure that this data is loaded 
into the area at execution time 



Loc 

in 

Dec 



Source Module 



Object Module 







1 

4 
24 
44 
54 
62 
68 K 



FIRST 



START 



© 



LA 10, BUFFER 
US ING^ DUMMY, 10 

^KEY,C'X' 



CLI 




DUMMY 



KEY 

CODE 

NAME 

ADDR 

WAGES 

HRS 

DEDUetf DS 

BAY' DS 



DS 
DS 
DS 
DS 

2^ 
•EfS 



C 

CL3 
CL2C" 
-CL20 
CLIO 
CL8 
CL6 
CL12 



END 



© 



• Ensure that the locations of 
the symbols in the dummy section 
actually correspond to the locations 
of the data being described 

• Establish the addressability 

of the dummy section in combination 
with the storage area (see F1A) . 

You can then refer to the unformatted 
data symbolically by using the 
symbols defined in the dummy section. 
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Specifications 



The DSECT instruction identifies 
the beginning or continuation of 
a dummy control section (dummy 
section) . One or more dummy sections 
can be defined in a source module. 

The DSECT instruction can be used 
anywhere in a source module after 
the ICTL instruction, or after any 
source macro definitions that may 
be specified. 

The format of the ESECT instruction 
statement is given in the figure 
to the right. 



DSECT 



The symbol in the name field, if 
specified, identifies the dummy 
section. If several ESECT 
instructions within a source module 
have the same symbol in the name 
field, the first occurrence initiates 
the dummy section and the rest 
indicate the continuation of the 
dummy section. 

NOTE: A DSECT instruction with 
a blank name field either initiates 
or indicates the continuation of 
the unnamed dummy section. 

The symbol in the name field 
represents the first location in 
the dummy section and has a length 
attribute value of 1 . 

The location counter for a dummy 
section is always set to an initial 
value of . However, the 
continuation of a dummy section 
begins at the next available location 
in that dummy section. 



Name 



Any Symbol 
or blank 



Operation 



DSECT 



Operand 



Not required 



Location in 
Hex 



Source Module 




0A2v 



FIRST START 



^"/^f/^'^W^mM^^WM 



RlsftX JCbBL H . ■ 



0A"¥? 
0A4 



20Q 



SECOND CSECT 



o 

DUtOlYl DSBCT 



CONTIN DS 



v> 



END 
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The source statements that follow 
a DSECT instruction belong to the 
dummy section identified by that 
DSECT instruction. 

NOTES : 

1. The assembler language statements 
that appear in a dummy control 
section are not assembled into 
object code. 

2. When establishing the 
addressability of a dummy section, 
the symbol in the name field of 
the DSECT instruction or any symbol 
defined in the dummy section can 

be specified in a USING instruction. 

3. A symbol defined in a dummy 
section can be specified in an 
address constant only if the symbol 
is paired with another symbol from 
the same dunrmy section, and if the 
symbols have the opposite sign. 



FIRST 


START 







USING 


DUMMY1,10 

e 


DUMMY1 


DSECT 




A 
& 
C 


DS 
DS 
DS 


H 
H 
CL30 






• 
• 


, 


o 


SECOND 


CSECT 


9< 


ADC ON 


DC 


r\ 

A(FROM-TO; 


DUMMY1 


DSSCT 




TO 

.FROM 


ilUlBisSllt 


CI*8Q 
CL240 




* 


flfllilJltllUll 


Vf.'vf* 


# 




IllllSli 


lliillilill 













or USING A, 10 

O 



END 
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E3D ~ THE COM INSTRUCTION 






Purpose 



You can use the COM instruction 
to initiate a common control section 
or to indicate its continuation. 
A common control section is a 
reference control section that 
allows you to reserve a storage 
area that can be used by two or 
more source modules. 



How to Use a Coirmon Control Section 



The figure to the right illustrates 
a common control section. 

A common control section (common 
section) allows you to describe 
a common storage area in one or 
more source modules. 

When the separately assembled object 
modules are linked as cne program, 
the required storage space is 
res erved for the common control 
section. Thus, two or more modules 
share the common area. 

Only the storage area is provided; 
the assembler does not assemble 
the source statements that make 
up a common control section into 
object code. You must provide the 
data for the common area at execution 
time. 

I The assembler assigns locations 
to the symbols you define in a 
common section relative to the 
beginning of that ccmmcn section. 

I This allows you to refer symbolically 
to the data that will be loaded 
at execution time. Note that you 

| must establish the addressability 
of a common control section in every 
source module in which it is 
specified (see F1A) . If you code 
identical common sections in two 
or more source modules, you can 
communicate data symbolically between 
these modules through this common 
section. 

NOTE: You can also cede a common 
control section in a source module 
written in the FORTRAN language. 
This allows you to communicate 
between assembler language modules 
and FORTRAN modules. 



Loc 
in 


Source Modules 


C 


Object Modules 


Dec 




x 
60 

o 


A START 

A/L 10,=A(AREA) 
mr\ USING AREA ,10 

o 

ST 3, SUM 


i 






A 




ASlJA DS 15F 
SUM DS F 


B 




END 




N 
60 

• 


B START 

AIL 8,=A(AREA) 
W I USING AREA, 8 

o 

L 3 , SUM 


1 




COM 
AREA DS 15F 
SUM DS F 

• 
• 




END 









^.y 
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Specifications 



The COM instruction identifies the 
beginning or continuation of a 
common control section (common 
section) . 

One or more common sections can 
be defined in a source module. 



The COM instruction can be used 
anywhere in a source module after 
the ICTL instruction, or after any 
source macro definitions that may 
be specified. 

The format of the COM instruction 
statement is given in the figure 
to the right. 









^^^^^^H 


Name 


Operation 


Operand 


Any Symbol 
or blank 


COM 


Not required 










The symbol in the name field, if 
specified, identifies the common 

instructions within a source nodule 
have l&e same symbol in the name 

initiates the common section and 

NOTE: A COM instruction with a 
blank name field either initiates 
or indicates the continuation of 
the unnamed common section. 

The symbol in the name field 
represents the address of the first 
byte in the common section and has 
a length attribute value of 1. 

The location counter for a common 
section is always set to an initial 
value of . However, the 
continuation of a common section 
begins at the next available location 
in that common section. 

If a common section with the same 
name (or unnamed) is specified in 
two or more source modules, the 
amount of storage reserved for this 
common section is equal tc that 
required by the longest common 
section specified. 



Location in 
Decimal 



& 



400 



Source Modules 



Ro~ol« / 

600 



1000 




80 



A 

P 


START 





XYZ 
JPIELD 

BREAK 


COM 
DS 

♦ 

DS 


CL200 
CL200 


A 

P 


CSECT 




XYZ 


COM 
DS 

DS 


CL200 
CL200 



Reserved Storage 
for common control 
section XYZ when 
modules A and B 
are linkage edited 



END 



START 



XYZ COM 

TO DS CL80 

FROM DS CL240 




Section E: Program Sectioning 125 



The source statements that follow 
a CON instruction belong to the 
common section identified by that 
COM instruction. 

NOTES: 

1. The assembler language statements 
that appear in a common control 
section are not assembled into 
object code. 

2. When establishing the 
addressability of a common section, 
the symbol in the name field of 
the COM instruction or any symbol 
defined in the common section can 
be specified in a USING instruction. 



DOS Because the name entry of the COM 
instruction must be blank, a symbol 
defined in the common section must 
be used as the base address in a 
USING instruction. 



Source Module 



FIRST 


START 


A 




USING 


COMMON, 11 


COMMON 


COM 


'■■':■::.-■:■-■ y 


A 


DS 


3D 




B 


DS 


3F , 


> .-■ ; -.,_ . ■ 2 


C 


DS 


30H 


o 




• 


, 


: .-.. 


SECOND 


CSECT 




COMMON 


c6& 




D 


DS y 


CI.20 


-.- i: ' '-'■■- 


E 


DS 


CX30 


■■■ • 


F 


DS 


XL2000 


'•\* 




• 




."'"• ■ J?J 






. , 





© 

or USING A, 11 



END 






^toji 
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E4 - External Dummy Sections 

OS 
Only 

Purpose 



An external dummy section is a reference control section 
that allows you to describe storage areas for one or ircre 
source modules, to be used as: 

1. Work areas for each source module or 

2. Communication areas between two or more source modules. 



c 



When the assembled object modules are linked and loaded, 
you can dynamically allocate the storage required for all 
your external dummy sections at one time from one source 
module (for example, by using the GETMAIN macro 
instruction) . This is not only convenient but you save 
space and prevent fragmentation of virtual storage. 

To generate and use external dummy sections, you need to 
specify a combination of the following: 



1. The DXD or DSECT instruction 

2. The Q-type address constant 

3. The CXD instruction. 



S 



8 



Generating an External Dummy Section 



An external dummy section is 
generated when you specify a DXD 
instruction or a DSECT instruction 
in combination with a Q-type address 
constant that contains the name 
of the DSECT instruction. 



You use the Q-type address constant 
to reserve storage for the offset 
to the external dummy section whose 
name is specified in the operand. 
This offset is the distance in bytes 
from the beginning of the area 
allocated for all the external dummy 
.sections to the beginning of the 
external dummy section specified. 
You can use this offset value to 
address the external dummy section. 
The Q-type address constant is 
described in G3M. 



Source Module 



FIRST START 



I* 


DXD 


3D | 


IB 


DXD 


2FL4 |\ 




EXT 

El 

E2 

E3 

E4 


DSECT 

DS 

DS 

DS 

DS 


3C 
1C 
10H 
2 OF 


QA 
QB 
QEXT 


DC 
DC 
DC 


Q(A) 
Q(B) 
Q(EXT) 




DUMMY 


DSECT 




Dl 


DS 


F 


D2 


DS 


2D 



END 



Area allocated to 

contain external 

dummy sections 



EXT 



offset to A 




\ t offset to B 



offset to 
EXT 



Not an external 
dummy section 
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How tc Use External Euinry Sections 

To use an external dummy section, you irust dc the following 
(as illustrated in the figure below) : 

^ fc Identify and define the external duirrny section. The 

^^ assembler will compute the length and alignment required. 

^m Provide a Q-type constant f cr each external duirmy section 
defined. 

Use the CXE instruction tc reserve a fullwcrd area into 

©which the linkage editor or loader will insert the tctal 
length of all the external dummy secticns that are specified 
in the source modules of your program. The linkage editcr 
computes this length frcm the lengths cf the individual 
external dummy sections supplied fcy the assembler. 

^fr Allocate a storage area using the computed tctal length. 

^fr load the address of the allocated area into a register 
^^ (for this exairple, register 11). Note that register 11 / 
must contain this address throughout the whole prcgrair. 

^feiAdd, to the address in register 11, the offset into the 
^^ allocated area of the desired external dummy section. 

The linkage editcr inserts this cffset into the fullwcrd 

area reserved by the appropriate Q-type address constant. 

G h Establish the addressability cf the external dummy section 

^^ in combination with the portion of the allocated area ^^-^ 

reserved for the external dummy section. 

tffc You can now refer symbolically to the locations in the 
^^ external duiriry secticn. 

Kote that the source statements in an external duiriry secticn 
are not assembled into object cede. Thus, at execution 
time you must insert the data described into the area 
reserved for the external dummy sections. 
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Linkage 
editor 



Source Modules 




Double word 
Boundary 



200 

bytes 
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E5 - Defining an External Dummy 



E5A — THE DXD INSTRUCTION 



Purpose 



The DXD instruction allows you to 
identify and define an external 
dummy section. 



Specifications 






The DXD instruction defines an 
external dummy section. The DXD 
instruction can be used anywhere 
in a source module, after the ICTL 
instruction or after any source 
macro definitions that may be 
specified. 

NOTE: The DSECT instruction also 
defines an external dummy section, 
but only if the symbol in the name 
field appears in a Q-type address 
constant in the same source module. 
Otherwise, a DSECT instruction 
defines a dummy section. 

The format of the EXE instruction 
is given in the figure to the right. 

dfc The symbol in the name field must 
^^ appear in the operand of a Q-type 
address constant. This symbol 
represents the address of the first 
byte of the external dummy section 
defined and has a length attribute 
value of 1 . 

^m The subfields in the operand field 
are specified in the same way as 
in the DS instruction. The assembler 
computes the amount of storage and 
the alignment required for an 
external dummy section from the 
area specified in the operand field. 

The linkage editor or loader uses 
the information provided by the 
assembler to compute the total 
length of storage required for all 
external dummy sections specified 
in a program. 

NOTE: If two" or more external dummy 
sections for different source modules 
have the same name, the linkage 
editor uses the most restrictive 
alignment and the largest section 
to compute the total length. 







I 


Name 


Operation 


Operand 


A symbol 


DXD 


Same format as the operand 
of a DS instruction 






Cf | Subfields 


Duplication I Type Modifiers] Nominal 
Factor Value 


Example: 






A 
I 

A^OFFSET 


DXD 
DC 


10FL3 
Q(A) : 



^y 
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E5B — THE CXD INSTRUCTION 



Purpose 



The CXD instruction allows you to 
reserve a fullword area in storage. 
The linkage editor or loader will 
insert into this area the total 
length of all external dummy sections 
specified in the source modules 
that are assembled and linked 
together into one program. 



'f*\ 



Specifications 



The CXD instruction reserves a 
fullword area in storage, and it 
can appear in one or more of the 
source modules assembled and combined 
by the linkage editor into one 
program. 

The format of the CXE instruction 
statement is given in the figure 
to the right. 









^^^^^^H 


Name 


Operation 


Operand 


A symbol 
or blank 


CXD 


Not required 



e 



The symbol in the name field, if 
specified, represents the address 
of a fullword area aligned on a 
fullword boundary. This symbol 
has a length attribute value of 
4. The linkage editor or loader 
inserts into this area the total 
length of storage required for all 
the external dummy sections specified 
in a program. 



Exam pie: 

LENGTH 


CXD 


Object Code 
n Hex 




Full word 
boundary 




4 bytes 




xxxxxxxx | 
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Section F: Addressing 



This section describes the techniques and instructions 
that allow you to use symbolic addresses when referring 
to data. You can address data that is defined within the 
same source nodule or data that is defined in another 
source module. Symbolic addresses ar« more meaningful 
and easier to use than the corresponding object code 
addresses required for machine instructions. Also, the 
assembler can convert the symbolic addresses you specify 
into their object code form. 



Fl — Addressing Within Source Modules: Establishing Addressability 



C 



e 



By establishing the addressability 
of a control section* ycu can refer 
to the symbolic addresses defined 
in it in the operands cf nsa chine 
instructions. This is much easier 
than coding the addresses in the 
base-displacement form required 
by the System/370. The symbolic 
addresses you code in the instruction 
operands are called implicit 
addresses , and the addresses in 
the base -displacement form are 
called explicit addresses , both 
of which are fully described in 
E5B. 

The assembler will conyert these 
implicit addresses for you into 
the explicit addresses required 
for the assembled object code cf 
the machine instruction. However, 
you must supply the assembler with: 

1. A base address from which it 
can compute displacements to the 
addresses within a control section 
and 

2. A base register to hold this 
base address. 



© 



FIRST START 



Equivalent < 



© 

LA 10, ADDRESS 



LA 10, X' 




40 ADDRESS DC C ' SAMPLE ' 



END 



|41 A|0|C040 


© 


| 41 A| 0|C040 
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How to Establish Addressability 



To establish the addressability 
of a control section, you must, 
at coding time: 



A • Specify a base address from which 
^^ the assembler can compute 



Specify a 
nbl 
displacements 



©• Assign a base register to contain 
this base address 

^m • write the instruction that loads 
the base register with the base 
address. 

At assembly time, the implicit 
addresses you code are ronvgrted 

O into their explicit base-displacement 
form : then, they are assembled intc 
the object code of the machine 
instructions in which they have 
been coded. 

©At execution time, the base address 
is leaded into the base register 
and should renain there throughout 
the execution of your program. 



Location 
in Hex 



2 
2 
A 



Source Module 



Object Code 
in Hex 



FIRST 



BEGIN 



START 
BALR 12,0 
USING BEGIN ,12 



Displacement 



22 




oo 



CONADR DC 



F'22 



5, CONADR 



END 







F1A - THE USING INSTRUCTION 






Purpose 



The USING instruction allows you to specify a base address 
and assign one or more base registers. If you also load 
the base register with the base address, you have 
established addressability in a control section. 

To use the USING instruction correctly you should: 

1. Know which locations in a control section are made 
addressable by the USING instruction 

2. Know where in a source module you can use these 
established addresses as implicit addresses in instruction 
operands. 
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The Range of a USING Instruction 



The range of a USING instruction 
(called the USING range) is the 
4,096 bytes beginning at the base 
address specified in the USING 
instruction. Addresses that lie 
within the USING range can he 
converted from their implicit to 
their explicit form; those outside 
the USING range cannot be converted . 

The USING range does not depend 
upon the position cf the USING 
instruction in the source module; 
rather, it depends upon the location 
of the base address specified in 
the USING instruction. 

NOTE: The USING range is the range 
of addresses in a control section 
that is associated with the base 
register specified in the USING 
instruction. If the. USING 
instruction assigns mere than one 
base register, the composite USING 
range is the sum of the USING ranges 
that would apply if the base 
registers were specified in separate 
USING instructions. If register 
is specified as the base register , 
the USING range will be location 
through 4 095 regardless of the base 
address specified. 



The Domain of a USING Instruction 



The domain of a USING instruction 
(called the USING domain) begins 
where the USING instruction appears 
in a source module and continues 
to the end of the source module. 
(Exceptions are discussed later 
in this subsection, under NOTES 
ABOUT THE USING DOMAIN.) The 
assembler converts implicit address 
references into their explicit form: 

1. If the address reference appears 
in the domain of a USING instruction 
and 

2. If the addresses referred to 
lie within the range of the same 
USING instruction. 

The assembler does not convert 
address references that are outside 
the USING domain. The USING domain 
depends on the position of the USING 
instruction in the source module 
after conditional assembly, if any, 
has been performed. 
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Source Module 



USING 
range 



FIRST 



START 



5 , INSIDE 



© 



Will not be 
converted 



USING BASADR,BASREG 



USING 
domain 



5, INSIDE Q 



L 5, OUTS IDE 



Cannot be 
converted 



BASADR DS 



© 



INSIDE 



DS 



P 



BASADR44095 



ST 5 , INSIDE 



OUTSIDE DS F 



END 
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How to Use the USING Instruction 



o 



You should specify your USING 
instructions so that: 

1. All the addresses in each control 
section lie within a USING range 
and 

2. All the references for these 
addresses lie within the 
corresponding USING domain. 

You should therefore place all USING 
instructions at the beginning of 
the source nodule and specify a 
base address in each USING 
instruction that lies at the 
beginning of each control section. 

FOR EXECUTABLE CONTROL SECTIONS ; 
The figure to the right illustrates 
a way of establishing the 
addressability of an executable 
control section (defined by a START 
or CSECT instruction) . You specify 

I a base address and assign a base 
register in the USING instruction. 

(At execution time the base register 
is loaded with the correct base 
address. 

Note that for this particular 
combination of the BALR and USING 
instructions, you should code them 
exactly as shown in the figure to 
the right. 









S 












Location 
in Decimal 


Source Module m£ Address of 
WM BEGIN 










2 
~5 

6 
10 

4097 


FIRST 
BEGIN 

A 
B 
C 


START 0^^ 
BALR 12,0 
USING * 12 

L 3,S ^ 
ST 3f |'. *f 

DS F ■ 

DS P ' ' 
DS F k 


' 








Same 
address 
S as BEGIN 






USING 
range 












f:r' 










USING 
domain 






END 


A - 
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If a control section is longer than 4096 bytes, you must 
assign more than one base register. This allows you tc 
establish the addressability of the entire control section 
with one USING instruction as shown in the figure on the 
opposite page. 

The assembler assumes that the base registers that you 
assign contain the correct base addresses. The address 
of HERE is loaded into the first base register. The 
addresses HERE+4096 and HERE+8192 are loaded into the 
second and third base registers respectively. 

Note that you roust define the address, EASES , within the 
first part of the total USING range, that is, the addresses 
covered by base register 9. This is because the explicit 
address converted from the implicit address reference , 
is assembled into the LM instruction. At execution time, 
the assembled address must have a base register which 
already contains a base address at this point; the only y 
base register loaded with its base address is register 
9. 

The addressability of addresses in the USING range covered 
by the second and third base registers is not completely 
established until after the LM instruction. 






NOTE: Addresses specified in address constants (except 
the s-type) are not converted to their base-displacement 
form. 
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Source Module 



c 



USING 
range 



c 

9 


LONG START 
4^ BALR 
_ V USING 
HERE LM 

i B 
f BASES DC 

BEGIN DS 




9,0 

HERE, 9, 10, 11 

10,11,MMRJESA 

BEGIN ^^ 

A ( HERE-HW96 , HERE+8 1 9 2 ) 

0H 






HERE+4095 


















10 
11 




HER E+ 4096 






















USING 
domain 


















HERE+8192 
















HERE+12287 
















END 







o 



Section F: Addressing 139 






FOR REFERENCE CONTROL SECTIONS ; 
The figure to the right illustrates 
how to establish the addressability 
of a dummy section. A dummy section 
is a reference control section 
defined by the DSECT instructions. 
Examples of establishing 
addressability for the ether 
reference control sections are given 
in E3E and E4. 

ffc P.s the base address , ycu shculd 
^^ specify the address of the first 
byte of the duirrry secticn, sc that 
all its addresses lie within the 
4^ pertinent USIKG range . 

OThe address you load into the base 
register must be the address of 
the storage area being formatted 
by the dummy section. 

Note that the assembler assumes 

Othat you are referring to the 
symbolic addresses of the dummy 
section, and it computes 
displacements accordingly. However, 
at execution time, the assembled 
^^ addresses refer to the location 
^m of real data in the storage area . 









Source Module 






FIRST 


START 






BALR 12,0 








USING *,12 


© 






LA 11, INPUT 






USING .INDATA ,11 






o 




© 


-INPUT 


DS 


XL200 








USING 










domain 






L 


3,F 


© 




"iNDATA 


DSECT 








A 


DS 0XL200 






USING 




range 


F 


DS F 






© 




END 


1 



w 
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Specifications for the USING Instruction 



USING 






The USING instruction roust be coded 
as shown in the figure to the right. 

The operand, EASE, specifies a base 
address, which can be a relocatable 
or absolute expression. The value 
of the expression roust lie between 
-2 2 * and 2 a *-1. " 

The remaining operands specify from 
1 to 16 base registers. The operands 
must be absolute expressions whose 
values lie in the range through 
15. 

The assembler assumes that the first 
base register (BASREG1) contains 
the base address BASE at execution 
time. If present, the subsequent 
operands , BASREG2 , BASREG3 , . . . , 
represent registers that the 
assembler assumes will contain the 
address values, EASE+4096, 
BASE+8192,. .. » respectively. 



Name 



Sequence 
symbol or 
blank 



Example: 



Operation 



USING 



Operand 



BASE , BASREG1 [", BASEREG21 

e © 



USING BASE, 9, 10 ,11 

Logical Equivalent 

USING BASE , 9 
USING BASE+4096,10 
USING BASE+8192,11 



NOTES ABOUT THE USING DOMAIN : The 
domain of a USING instruction 
continues until the end of a source 
module except when: 

i • A subsequent CROP instruction 
specifies the same base register 
or registers assigned by the 
preceding USING instruction. 

• A subsequent USING instruction 
specifies the same register or 
registers assigned by the preceding 
USING instruction. 



Source Module 





BREAK START 



USING BASE1.10 



BASE1 



DS 



(DROP 



OH 



10 




BASE2 DS 




USING BASE 1 JUL 




USING . BASE 2 ,11 



Third 

USING 

domain 



END 
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NOTES ABOUT THE USING RANGE ; Twc 
USIKG ranges coincide when the same 
kase address is specified in twc 
different USIKG instructions, even 
though the kase registers used are 
different. When two USING ranges 
coincide, the asseirfcler uses the 
higher numbered register for 
asseirfcling the addresses within 
the common USING range. In the 
example, this applies cnly tc the 

i implicit addresses that appear after 
the second USING instruction. In 
effect, the first USIKG domain is 

I terminated after the second USING 
instruction. 



Source Module 



common 

USING 

range 



CONFLICT START 

USING A, 10 

A DS OH 



first 

USING 

domain 



DS 



USING A, 111 



(A+4095) 



second 
USING 
domain 



END 



Vy f 
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Two USING ranges overlap when the 
base address of one USING instruction 
lies within the range of another 

^k USING instruction. When twc ranges 
t overlap , the assembler computes 

^9 displacements frcir the base address 
that gives the smallest displacement; 

Oit uses the corresponding base 
register when it assembles the 
addresses within the range overlap. 
-^ This applies only to implicit 
^P addresses that appear after the 
second USING instruction. 



Source Module 



first 

USING 

range 



second 
USING 
range 



OVERLAP START 

USING RANGE1,10 



RANGE 1 



DS 



DS 



OH 



OH 



first 

USING 

domain 



DS 
USING 



F © 

RflNGJftjfr— 



second 
USING 
domain 



(RANGE2+4095) 



END 




EASE PEGISTEFS EOR AESOIUTE 
ADEBESSES : Absolute /addresses used 
in a source mcdule must alsc be 
made addressable. Absolute addresses 
require a base register ether than 
the base register assigned to 
relocatable addresses (as described 
above) . 

However, the asseirhler does net 
need a USING instruction to convert 
absolute implicit addresses in the 
range through 4,095 to their 
explicit form. The assembler uses 
register as a base register. 
Emplacements are computed from 
the base address 0, because the 
assembler assumes that a base cr 
index of implies that a zero 
quantity is to be used in forming 
the address, regardless of the 
contents cf register 0. The USING 
domain for this automatic base 
register assignment is the whele 
of a source mcdule. 







Source Module 


Object Code 
in Hex 




AB 


S START 





fa 


\ 


USING 

range 

0-4095 




> \ 


LA 6,ll5f 


|41|6|0 00F| 


e © 












USING gk 

domain ^BF 


END 


* 4r _ 


„___ 
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For absolute implicit addresses 
greater than 1095, a USING 
instruction must be specified 
according tc the following: 

i • With a base address representing 
an absolute expression, and 

• With a base register that has 
not been assigned by a USING 
instruction in which a relocatable 
base address is specified. 

This base register irust be leaded 
with the base address specified. 







Source Module 




Object Code 
in Hex 






ABS 


START 










base register 








■ > „ 




LA 3,4095 
LA 3,1(3) 


A 


41 3|0 FFF 




®i 


141 3|3|0 001 


I 


USING ^4 09 6, 3- A 






USING 

range 

4096-8191 


o 

Y 


1 












( / 




\ 


f — 




■> 




LA 


. 7*15120 1- 


1 41 7| 3 400 




• 


USING 
domain 




/ - 






base 
register 




./ 






END 










displacement 

5120 
-4096 

1024 
































FIB 



V> 



THE DROP INSTRUCTION 



Purpose 



You can use the DROP instruction to indicate to the 
assembler that one or more registers are no longer available 
as base registers. This allows you: 

1. To free base registers for other programming purposes 

2. To ensure that the assembler uses the base register 
you wish in a particular coding situation, for example, 
when two USING ranges overlap or coincide (as described 
above in F1A, Notes about the USING range) . 
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Specifications 



The DROP instruction must be coded 
as shown in the figure to the right. 

Up to 16 operands can be specified. 
They must be absolute expressions 
whose values represent the general 
registers through 15. A DROP 
instruction with a blank operand v 
field causes all currently active 
base registers assigned by USING 
instructions to be dropped. 









DROP 


Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


DROP 


BASREG1 TbASREG^ . . . 
or blank 






e 



After a PROF instruction, the 
assembler will not use the registers 
specified in a DROP instruction 
as base registers. A register made 
unavailable as a base register by 
a DROP instruction can be reassigned 
as a base register by a subsequent 
USING instruction. 



Source Module 



USING 
range 



DROPS 



START 

USING BASE ,10 



BASE 



DS 



USING 
domain 



DROP 




Register 10 
unavailable 
as a base 
register 



USING 



BASE,10i 



restored 

USING 

domain 



END 



c 
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A EROF instruction is net needed: 

• If the base address is being 
changed by a new USING instruction , 
and the same base register is 
assigned. However, the new base 
address must be loaded into the 
base register. Note that the 
implicit address "£" lies within 
the first USING dcirain, and that 
the base address to which it refers 
lies within the first USING range. 

• At the end of a source module. 



Source Module 




second 
USING 
range 



CHANGE START 



USING 



DS 



A, 9 
OH 



first 

USING 

domain 



LA 



OH 



9,B- 



>USING 



B,9 



/ 



second 
USING 
domain 






Vy 



END 



A 



146 



F2 — Addressing Between Source Modules: Symbolic Linkage 



This section describes symbolic 
linkage, that is, using symbols 
to communicate between different 
source modules that are separately 
assembled and then linked together 
by the linkage editor. 



How to Establish Symbolic Linkage 



c 



You must establish symbolic linkage 
between source modules so that you 
can refer or branch tc symbolic 
locations defined in the control 
sections of external source modules. 
To establish symbolic linkage with 
an external source module you roust 
do the following : 

1. In the current source module, 
you must identify the symbols that 
are not defined in that source 
module, if you wish to use them 

^ in instruction operands. These 
m symbols are called external symbols , 
because they are defined in another 
(external) source module. You 
identify external symbols in the 
EXTRN or WXTRN instruction or the 
V-type address constant. 

2. In the external source modules, 
you must identify the symbols that 
are defined in those source modules 
and to which you refe^r from the 

^ current source module. These symbols 
P are called entry symbols because 

they provide points cf entry to 

a control section in a source module. 

You identify entry symbols with 

the ENTRY instruction. 

3. You must provide the A-type or 
Y-type address constants needed 

by the assembler tc reserve storage 
for the addresses represented by 
the external symbols. 

- The assembler places information 
about entry and external symbols 
in the External Symbol Dictionary. 
The linkage editor uses this 
|fc information to resolve the linkage 
" addresses identified by the entry 
and external symbols. 



Current Source 
Module 



Linked Object 
Modules 




Other 
(External) 
Source 
Modules 




^ ^.y 
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10 REFER TC EXTERNAL EST A: YOU 
should use the EXTRN instruction 
to identify the external symbol 
that represents data in an externa 1 
source module, if you wish to refer 
to this data symbolically. 

For example, you can identify the 
address of a data area as an external 
symbol and load the address constant 
specifying this symbol into a base 
register. Then, ycu use this base 
register when establishing the 
addressability of a dumry section 
that formats this external data. 
You can new refer symbolically tc 
the data that the external area 
contains. 

You must also identify, in the 
source module that contains the 
data area, the address cf the data 
as an entry symbol . 



Source Modules 



Linked 
Object Modules 



CURRENT START 

EXTRN BUFFER 



Of 



USING DATA, 10 



AD BUFF DC A (BUFFER) 



DATA 

KEY^ DS 
CODE ^ DS 
NAME "DS 
ADDR 
WAGES 
HRS 



DSECT 



DS 
DS 
DS 



DEDUCT DS 



PAY 



DS 



END 



END 




OTHER START ^ 

ENTRY BUFFER 



BSJF? m CXSQ 






^y 
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10 BRANCH 1C AN EXTERNAL AtERESS; 
You should use the V-type address 
constant to identify the external 
symfcol that represents the address 
in an external source module to 
which you wish tc branch. Fcr the 
specifications of the V-type address 
constant, see G3L. 

For example, you can lead intc a j 
register the V-type address constant 
that identifies the external syirbcl. 
Using this register, you can then 
branch to the external address 
represented by the symbol. 

If the symbol is the name entry 
cf a START or CSECT instruction 
in the other source ircdule, and 
thus names an executable control 
section, it is automatically 
identified as an entry symbol. 
If the symbol represents an address 
in the middle of a control section, 
you must, hewever, identify it as 
an entry symbol for the external 
source module. 

You can alsc use a combination of 
an EXTRN instructicn tc identify 
and an A-type address constant to 
contain the external branch address. 
However, the V-type address constant 
is more convenient because: 

1. Ycu do net have to use an EXTRN 
instructicn . 

2. The symbel identified is not 
considered as defined in the source 
module and can be us"ed as the name 
entry for any other statement in 
the same source ircdule. 





Source Modules 






CURRENT START ~ t 






L 3,EXTADR 
^BR 3 






© o 

EXTADR DC V (OTHER) 






END 




i 


"OTHER START 

ENTRY SUBRTN^fc 

SUBRTN PS OH 
END 
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F2A - THE EKTFY INSTRUCTION 






Purpose 

The entry instruction allows you 
to identify syiinfccls defined in a 
source module so that they can be 
referred to in another source ircdule. 
These symbols are entry symbols. 



Specifications 

The format of the ENTRY instruction 
is shewn in the figure to the right. 

ENTRY SYKECIS ; The following applies 
to the entry symbols identified 
in the operand field: 

• They must be valid symbols. 

• They must be defined in an 
^fc executable control section. 

-^ • They must not be defined in a 
^P dummy control section, a common 

control section, or an external 

control section. 

• The length attribute value cf 
entry symbols is the same as the 
length attribute' value of the symbol 
at its point cf definition. 

A symbol used as the name entry 
of a START or CSECT instruction 

Ois also automatically considered 
an entry symbol and dees not have 
to be identified by an ENTRY 
instruction. 

The assembler lists each entry 
-^ symbol of a source module in an 
^P External Symbol Eictionary along 
with entries for external symbols , 
common control sections, and external 
control sections. The maximum 
number of External Symbol Dictionary 
entries for each source module is 
399. 

00$ The maximum number of external 

symbol dictionary entries (control | 
sections and external symbols) 
allowed is S13L the mxm 

allowable mariSer of entry symbols 
identified fef; t&e. Iiitint i«st««ctio«> 
is fGCU ' 

^m NOTE : A symbcj identified in an 
ENTRY instruction counts towards 
this maximum, even thcugh it may 
not be used in the name field of 
a statement in the scurce module 
nor constitute a valid entry point. 







ENTRY 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


ENTRY 


One or more 
relocatable 
symbols separated 
by commas 



Wv 





Source Module 


Entry in External mm 
Symbol Dictionary 


A 






Symbol 


Type Code 


FIRST 


START 

• 





FIRST 


SD 




ENTRY 


SUBRTN, INVALID 


SUBRTN 


LD 


o 

SUBRTN 


• 

DS 

• 


OH 


INVALID 

e 


LD 


DUMMY 


DSECT 




DUMMY 


none 


e 

INVALID 


• 

DS 

• 

END 


F 


INVALID 


- 



i) 
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F2B - THE EXTRN INSTRUCTION 



Purpose 



The EXTRN instruction allows you 
to identify symbols referred tc 
in -a source module tut defined in 
another source module. These symbcls 
are external symbols. 






Specifications 



The format cf the EXTRN instruction 
statement is shown in the figure 
to the right. 



EXTERNAL SYMBOLS: The following 
applies to the external symtols 
identified in the operand field: 

• They must be valid symbols . 

• They must not be used as the 
name entry cf a source statement 
in the source module in which they 
are identified. 

• They have a length attribute 
value of 1. 

• They must be used alcne and 
cannct be paired when used in an 
expression (fcr pairing cf terms 
see C6) . 

The assembler lists each external 
symbol identified in a source module 
in the External Symbcl Dictionary 
along with entries for entry symtols, 
common control sections, and external 
control sections. The maximum 
number cf External Symbcl Dictionary 
entries for each source module is 
399. 

The maximum number cf external 
symbol dictionary entries <contrcl 
sections and external symbols) 
allowed is 511. The maximum 
allowable number of entry symbols 
identified by the ENTRY instruction 
is 200, 

NOTE: The symbcl specified in a 
"V-type address constant is implicitly 
identified as an external symbcl 
and ccunts towards this maximum. 









EXTRN 


Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


EXTRN 


One or more relocatable 
symbols separated by 
commas 



Source Modules 




Entry in External Wm 
Symbol Dictionary^^ 




Symbol 


Type Code 


CURRENT START 

EXTRN OTHER 

o 

L 3 , EXTAD 
BR 3 

• 

L 4 ,ADSUBRT 
BR 4 

e 

EXTAD DC A (OTHER) 
ADSUBRT DC V (SUBRTN) 

© 

END 




CURRENT 
OTHER 

SUBRTN 


SD 
ER 

ER 










OTHER 
SUBRTN 


SD 
LD 


OTHER START 

ENTRY SUBRTN 

SUBRTN DS OH 

• 

END 
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T2C - THE WXTRN INSTRUCTION 






Purpose 

The WXTPN instruction allows you 
to identify symbols referred tc 
in a source module but defined in 
another scurce module. 

The WXTPN instruction differs from 
the EXTRN instruction as fellows: 

The EXTRN instruction causes the 
linkage editor to make an automatic 
search of libraries to find the 
module that contains the external 
symbols that you identify in its 
operand field. If the module is 
found, linkage addresses are 
resolved; then the module is linked 
to your module, which contains the 
EXTRN instruction. 

The WXTRN instruction suppresses 
this automatic search of libraries. 
The linkage editor will only resolve 
the linkage addresses if the external 
symbols that you identify in the 
WXTRN operand field are defined: 

1. In a module that is linked and 
loaded along with the object mcdule 
assembled from your source module 
or 

2. In a module brought in from a 
library due tc the presence cf an 
EXTRN instruction in another module 
linked and leaded with ycurs. 

Specifications 

The format cf the WXTRN instruction 
statement is shown in the figure 
to the right. 

EXTERNAL SYMBOLS : The external 
symbols identified by a WXTRN 
instruction have the same properties 
as the external symbols identified 
ty the EXTRN instruction . However, 
the type code assigned to these 
external symbols differs. 

BOTE: If a symbol, specified in 
a V-type address constant , is also 
identified by a WXTRN instruction 
in the same scurce mcdule, it is 
assigned the same type code as the 
symbol in the WXTRN instruction. 

If an external symbol is identified 
by both an EXTRN and WXTRN 
instruction in the same source 
module, the first declaration takes 
precedence , and subsequent 
declarations are flagged with warning 
messages. 



\^' 









WXTRN 


Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


WXTRN 


One or more relocatable 
symbols separated by 
commas 



Source Module 



FIRST START 
r ^P EXTRN OUT,A-^ 

O WXTRN WOUT,A % 
♦♦WARNING ♦♦-J 

VCON DC V(WOUT) 



END 



Entry in External 
Symbol Dictionary 



Symbol 



FIRST 
OUT 

WOUT 
WOUT 



Type Code 



SD 
ER 
ER 

WX 



WX 
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Section G: Symbol and Data Definition 



This section describes the assembly time facilities which 
you can use to: 

1. Assign values to symbols 

2. Define constants and storage areas 

3. Define channel command words. 

By assigning an absolute value to a symbol and then using 
that symbol to represent, for example, a register or a 
length, you can code machine instructions entirely in 
symbolic form. 



61 - Establishing Symbolic Representation 



e 






You define symbols tc be used as 
elements in your programs. This 
symbolic representation is superior 
to numeric representation because: 

• You can give meaningful names 
to the elements; 

• You can debug a program more 
easily, because the symbols are 
cross-referenced tc where they are 
defined and used in your program. 
The cross-referenced statement 
numbers containing the symbols are 
printed in your assembly listing. 

• You can maintain a program more 
easily, because you can change a 
symbolic value in one place and 

its value will be changed throughout 
a program. 

OSome symbols represent absolute 
values , while others represent 
Jfe relocatable address values . The 
^^ relocatable addresses are of: 

dfr instructions 

4^ constants 

4fr storage areas . 

You can use these defined symbols 
in the operand fields of instruction 
statements to refer to the 

dlfc instructions, constants, or areas 

^^ represented by the symbol. 







Source Module 






FIRST 


START 

• 






e 


DATAREG 
EIGHTY 
TW040 
BASREG 


EQU 
EQU 
EQU 
EQU 


10 
80 
240 
12 




o 


RELOC 


EQU 

• 

BALR 
USING 

• 

B 

• 


* 

e 

12,0 
* , BASREG 

INSTR-^^^^^^ 


0k 


e 


INSTR 


MVC 

L 

• 


TO,FROM^ """ / 

DATAREG , DATACON ' 


V 


© 


DATACON 


DC 


P.' 3 ' 




o 


TO 


DS 


CL (EIGHTY) 






FROM 


DS 

• 
• 

END 


CL(TWO40) 
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Assigning Values 



x 



You can create symbols and assign 
them absolute or relocatable values 
anywhere in a source module with 
an EQU instruction (see G2A) . You 
can use these symbols instead of 
the numeric value they represent 
in the operand of an instruction. 



Defining and Naming Data 



DATA CONSTANTS ; You can define 
a data constant at assembly time 
that will be used by the machine 
instructions in their operations 
at execution time. The three steps 
for creating a data constant and 
introducing it into your program 
in symbolic form are: 

4b * define the data 

^h • provide a label for the data 

4% • refer to the data by its label . 

OThe symbol used as a label represents 
the address of the constant ; it 
is not to be confused with the 
^fe assembled ohject code of the actual 
^^ constant. 

Defining data constants is discussed 
in G3. 

LITERALS ; You can also define data 
at its point of reference in the 
operand of a machine instruction 
dlfc by specifying a literal . 

Literal constants are discussed 
in G3C. 

STORAGE AREAS ; You must usually 
reserve space in virtual storage 
at assembly time for insertion and 
manipulation of data at execution 
time. The three steps for reserving 
virtual storage and using it in 
your program are: 

^m • define the space 

dfr • provide a label for the space 

^fe • refer to the space by its label . 



Defining storage areas is discussed 
in G3N. 



Equivalent 
A LABEL 


Source Code 

• 

L 5, LABEL ^ 
,L 5 / =F , 202'\ 

© 

dc f'202' 

O 


Object Code 
in Hex 

lOOOOOOCAi 


V© 


*|000O000CA 




e 





ST 


© 

5 , SPACE 




• 
• 


o 


^^SPACE 


DS 


F 



c 
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CHANNEL COMKAND WORDS; When you 
define a channel command word at 
assembly time you create a command 
for an input or output operation 
to be performed at execution time. 
You should: 



• define the channel command word 

• provide a label fcr the word. 

Channel ccirirand words are discussed * 
in subsection G3C. 



G2 - Defining Symbols 



G2A -- THE ECU INSTRUCTION 






Purpose 



The EQU instruction allows you to 
assign absolute or relocatable 
values to symbols. You can use 
it for the following purposes: 

4fc 1. To assign single absolute values 
^^ to syirbols 

©2. To assign the values of previously 
defined symbols or expressions to 
new symbols, thus allowing you to 
use different mnerrcnics fcr different 
purpcses. 

^p3. To compute expressions whose 
values are unknown at coding time 
or difficult to calculate. The 

O value of the expression is then 
assigned to a symbol. 





INSTR 
^ABS 


BALR 

EQU 
EQU 
EQU 

EQU 




12,0 

o 

X'A2* 






Absolute 
Value 




ABS 
INSTR 

J 






^HEXA2 

BEGIN ^ 


© 


Qexpr 




Relocatable 
Value 




A-(B+C)/33-D 










© 





c 
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Specifications 



The EQU instruction can be used 
anywhere in a source module after 
the ICTL instruction, or. after any 
source macro def initions^ that may 
be specified. Note, however, that 
the E£U instruction can initiate 
an unnamed control section (private 
code) if it is specified before 
the first control section (initiated 
by a START or CSECT instruction) . 

The format of the EQU instruction 
statement is given in the figure 
to the right. 

BOS Only one operand (expression 1) 
is allowed. 



Name 



An ordinary 
symbol or 
a variable 
symbol 



Operation 



EQU 




Operand 



4 options: 

Expression 1 

Expression^ Expression 2 

Expression 1, Expression 2, E xpre ss ion 3 

Expression 1, , Expfosokm $ 

OS 
only 



Indicates the 
absence of 
Expression 2 



Expression 1 represents a value. It 
must always be specified and can have 
a relocatable or absolute value. The 
assembler carries this value as a 
signed four-byte (32-bit) number; 
all four bytes are printed in the 
program listings opposite the symbol. 

Expression 2 represents a length 
attribute* It is optional . but, it ,.^.. s 

specified, it sosst have an absolu^l^ 
value in the range of through ,;? 
65.* $3.5* fbqp ression 3 represents a v 
type attribute* It is optional , but, 
if specified , must be a self-def ining 
term with * value in the range of $ 

Any symbols appearing in these three 
expressions must have been previously 
defined. 

EXPRESSION 1 (VALUE) ; The assembler 
assigns the relocatable or absolute 
value of expression 1 to the symbol 
in the name field at assembly time. 



V_y 
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If expression 2 is omitted, the assembler also assigns 
a length attribute value to the symbol in the name field 
according to the. length attribute value of the leftmost 
(or only) term of expression 1. The length attribute value 
(described in C4C) thus assigned is as follows (see figure 
on following page) : 

1. If the leftmost terrc is a location counter reference 
(*) , a self-defining term or a symbol length attribute 

value reference, the length attribute value is 1. Note 
that this also applies if the leftmost terir is a syirtcl 
that is equated tc any cf these values. 

2. If the leftmost term is a symbol that is used in the name 
field of a DC or DS instruction, the length attribute value 
is equal to the implicit or explicit length of the first (or 
only) constant specified in the DC or DS operand field. 

3. If the leftmost term is a symbol that is used in the 
name field of a machine instruction, the length attribute 

l value is equal to the length of the assembled instruction . 

4. Symbols that name assembler instructions, except the DC 
and DS instructions, have a length attribute value of one. 
However, the name of a CCW instruction has a length 

' attribute value of eight . 

NOTE: The length attribute value assigned in cases 2-4 only 
applies to the assembly- time value of the attribute. Its 
value at pre-assembly time, during conditional assembly 
processing, is always 1 . 



Further, if expression 3 is omitted, the asserrhler assigns 
a type attribute value cf "U" tc the syirbcl in the naire 
field. 
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Value 












assigned 










to 




Source Module 




Length Attribute Value 


symbol 










assigned to symbol 


is: 










in name field: 




SECTA 


START 

• 







At Assembly Time 

e 


At Pre-assembly Time 

o 




RR 


LR 


3,4 










RX 


A 


3, FULL 










SS 


MVC 

• 


TO, FROM 










FULL 


DC 


F'33' 










AREA 


DS 


XL2000 










TO 


DS 


CL240 










FROM 


DS 

• 


CL80 










ADCONS 


DC 

• 


AL1(A) ,AL2(B) ,AL3 (C) 








ADCCW 


ccw 

t 


2 , READER, X' 48' ,80 






Absolute 


A 


EQU 


X'FF' 




i 


1 


Absolute 


B 


EQU 


L ' FROM 


o 


i 


1 


Relocatable 


C 


EQU 


*+4 


i 


1 


Absolute 


D 


EQU 


A*10 




i 


1 


Relocatable 


E 


EQU 


FULL 




4 


1 


Relocatable 


F 


EQU 


AREA+1000 


o 


2000 


1 


Relocatable 


G 


EQU 


TO 


240 


1 


Absolute 


H 


EQU 


FROM-TO 


80 


1 


Relocatable 


I 


EQU 


ADCONS 




1 


1 


Relocatable 


J 


EQU 


RR 


© 


2 


1 


Relocatable 


K 


EQU 


RX 


4 


1 


Relocatable 


L 


EQU 


SS 




6 


1 


Relocatable 


M 


EQU 


SECTA 




1 


1 


Relocatable 


N 


EQU 


7\ nfT'TnT 


A 


8 


1 


AULLW 


IF 



/#">, 



\^J/' 
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i^^n^fK^SK^^ is 

specified ', the assembler assigns its value as a length 
attribute value to the symbol in the name field. This value 
overrides the normal length attribute value implicitly 
assigned from expression 1 . 

If expression 2 is a self-defining term, the assembler also 
assigns the length attribute value to the symbol at 
pre-assembly time (during conditional assembly processing) . 

3 is 



specified, It must be a self-defining term. The assembler 
assigns its EBCDIC value as a type attribute value to the 
symbol in the name field. This value overrides the normal 
type attribute value implicitly assigned from expression 1 . 
Note that the type attribute value is the EBCDIC character 
equivalent of the value of expression 3. 



c 



Value 


Source Module 




Length Attribute 


Type Attribute 


assigned 








Value assigned 


Value assigned 










At 


At Pre- 












Assembly 


assembly 












Time 


Time 






r±KST 


START 

4 






e 






AREA 


DS 


XL2000 

Implicit 


2000 


2000 


X 




SDT 


EQU 

• 


X * FF ' Attribute 
Values 


1 

1 


1 

1 


u 
u 




ASTERISK 


EQU 


* 








Value of 1 
AREA J 


A 


EQU 


AREA, 1000 


1000 


1000 


u 


255 

Value of 


B 


EQU 


SDT, 4 A 


4 


4 


u 


Location 


C 


EQU 


ASTERISK, 4 


4 


4 


u 


Counter at 














ASTERISK J 




/• 












D 


EQU 


AREA, ,C'F' 


2000 


1 


:]• 




E 


EQU 


SDT, ,C'N' 


1 


1 




F 


EQU 


ASTERISK, ,C'A' 


1 


1 




G 


EQU 


AREA,1000,C'l' 


1000 


1000 


1 




H 


EQU 


SDT,4,C«F* 


4 


4 


F 




I 


EQU 


ASTERISK, 4,C 'A' 


4_ 


4 


A 




J 


EQU 


AREA, 100, 198^ 


100 p 100 


F 
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Using Preassembly Values 



<f\ 



You can use the preassembly values assigned by the assembler 
in conditional assembly processing. 

If only expression 1 is specified, the assembler assigns a 
preassembly value of 1 to the length attribute and a 
preassembly value of U to the type attribute of the symbol. 
These values can be used in conditional assembly (although 
references to the length attribute of the symbol will be 
flagged) . The absolute or relocatable value of the symbol, 
however, is not assigned until assembly, and thus may not be 
used at preassembly. 

If you include expressions 2 and 3 and wish feci nmm the >| 
explicit attribute values in preassembly processing, theft 



y>:§ 



• The symbol in the name field must be m ordinary symbol 



e Expression 2 and expression 3 must be single 
self -de fining terms 
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THE SYMBCI IN THE N3ME EIELE; The assembler assigns an 
absolute cr relocatable value, a length attribute value, 
and a type attribute value to the symbol in the name field. 

The absolute cr relocatable value of the symbol is assigned 
at assembly time, and is therefore not available for 
conditional assembly processing at pre-assembly time. 

:,^Nt-.%3^i' m$ -lwggtb attrijbufcg values sf *l*e; .$%&p&T'~**# . ;.' v*- 
^gj^e :^ji^^ ;.ik ;tAte pme field -'^st;*^:^ 

G3 - Defining Data 

This section describes the EC, ES, and CCW instructions; 
these instructions are used to define constants, reserve 
storage and specify the contents of channel command wcrds 
respectively. Ycu can alsc provide a label for these 
instructions and then refer to the data symbolically ir 
the operands cf machine and assembler instructions. Ihis 
data is generated and storage is reserved at assembly time, 
and used by the machine instructions at execution tine. 
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G3A — THE EC INSTRUCTION 



Purpose 



You specify the DC instruction to 
define the data constants you need 
for program execution. The DC 
instruction causes the assembler 
to generate the binary representation 
of the data constant you specify, 
into a particular location in the 
assembled source module^ this is 
done at assembly time. 

TYPES OF CONSTANTS; The EC 
instruction can generate the 
following types of constants: 

Binary constants — to define bit 
patterns 

Character constants — to define 
character strings or messages 

Hexadecimal constants — to define 
large bit patterns 

Fixed-Point constants — for use 
by the fixed-point and other 
instructions of the standard set 

Decimal constants — for use by 
the decimal instructions 

Floating-Point constants — for 

use by the floating-point instruction 

set 

i Address constants — to define 
addresses mainly for the use of 
the fixed-point and ether 
instructions in the standard 
instruction set. 



^P FLAG DC B'00010000' 

Q CHAR DC C STRING OF CHARACTERS' 

A PATTERN DC/ X'FFOOFFOO' 

©I 

o 

© 
© 





L 


3, FCON 


FCON 


DC 


F'100 1 




AP 


AREA, PCON 


PCON 


DC 


P'100 1 


AREA 


DS 


P 




LE 


2 , ECON 


ECON 


DC 


£•100.50' 




L 


5, ADC ON 


ADCON 


DC 


A ( SOMWHERE 



\^y 



V 
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G3B — GEBEKAI SPECIF I CAT IONS FOR 
CONSTANTS 



c 



The general format of the EC 
instructions statements is shewn 
in the figure to the right. 



The symbol in the name field 
represents the address of the first 
byte of the assembled constant. 
If several operands are specified, 
the first constant defined is 
addressable by the symbol in the 
name field. The other constants 
can be reached by relative 
addressing. ~~~ 



Name 



Any Symbol 
or blank 



Operation 



DC 




Operand 



One or more 



[Operands separated 
' comms 




I n the format 
described in the 
next figure 



FIRSTCON DC F ' 2 ' ,X' Al ' ,C ' HUM' | 











Logical Equivalent 




\> 




FIRSTCON 


DC 


F'2' 




DC 


X'Al' 






DC 




C ' HUM ' 



LA 3, FIRSTCON 
CLI 5,4(3) 



Each operand in a EC instruction 
statement consists cf four subfields. 
The format cf a EC instruction 
operand is given in the figure tc 
the right. 

The first three subfields describe 
the constant, and the fourth sutfield 
specifies the nominal value of the 
constant to be generated. 



SUBFIELDS. 




Required Order 
if all subfields 
are specified 
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Rules for the DC Operand 

^P 1. The type subfield and the nominal 
4t value must: always be specified. 



2. The duplication factor and 
modifier subfields are optional. 

A 3. When multiple operands are 
^^ specified, they can be of different 
types. 



4. When multiple nominal values 
are specified in the fourth subfield, 
they must be separated by commas 
and be of the same type. 

I 5. The descriptive subfields apply 
to all the nominal values. 

NOTE: Separate constants are 
generated for each separate operand 
and nominal value specified. 



MUST 



DC F'200 



OPRNDS 

SEVERAL 
|VALUES 




DC C'FIRST' ,H'99' ,FL3'101' 



DC A (FIRST, SECOND, THIRD) 
DC F'100,200,300' | 



Logical Equivalent 



V 



SEVERAL 



VALUES 



|MIXED 



DC A(FIRST) 

DC A (SECOND) 

DC A (THIRD) 

DC F'100' 

DC F'200' 

DC F'300' 



o 



Multiple 
nominal 
values not 
allowed for 
character 
constant 



o 



DC AL3(ONE,TWO) , 2F ' 1 , 2 , 3 ' | 



Logical Equivalent 



V 



MIXED 



DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 



AL3(0NE) 

AL3(TW0) 

F'l' 

F'2' 

F'3' 

F'l' 

F'2' 

F'3' 



^^y 



© 

o 



6. No blanks are allowed: 

a. Between subfields 

b* Between multiple operands 

c. Within any subfields — 
unless they occur as part of 
the nominal value cf a character 
constant or as part of a character 
self-defining term in a modifier 
expression or in the duplication 
factor subfield. 



BETWEEN DC 10FL3'+456' 



SEVERAL DC C ' BOO HOC ,F ' 95 * ,H' 2 

// // 



© 

WITHIN DC C MESSAGE HAS BLANKS' 
r 

DC XL(A+B-C'N 6'+3) 'FO'- 



© 
© 



\ 
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Information about Constants 



SYMBOLIC ADDRESSES OF CONSTANTS; 
Constants defined by the DC 
instruction are assembled into an 
object module at the location where 
the instruction is specified. 
However, the type of constant being 
defined will determine whether 
the constant is to be aligned on 
a particular storage boundary or 
not. (see below under Alignment 
of Constants) . The value of the 
symbol that names the DC instruction 
is the address of the leftmost byte 
(after alignment) of the first or 
only constant. 



Source Code 



Object Code 
in Hex 



/HEXCON 



DC 



XL7'AD' 



^ 



000000000000AD 



^FULLCON DC F ' 8 



WANYCONS DC 




00000008 



f ,C'B' ,C'C',C'D' 



1 C2 C3 C4] 



C 



THE LENGTH ATTRIBUTE VALUE OF SYMBOLS 
NAMING CONSTANTS; The length 
attribute value assigned to the 
symbols in the name field of 
constants is equal to; 

The implicit length cf the constant 
when no explicit length is specified 
in the operand of the constant, 
or 

The explicitly specified length 
of the constant. 

NOTE; If more than one operand 
is present, the length attribute 
value of the symbol is the length 
in bytes of the first constant 
specified, according to its 
implicitly or explicitly specified 
length. 



Type of 
constant 


implicit 
Length 1 


Examples 


Value of Length 
Attribute 2 


B 


asTieeded 


DC B'10010000' 


1 


C 


as needed 


DC C'WOW* 

DC CL8'WOW'^ 


3 
8 


X 


as needed 


DC X'FFEEOO' \ 
DC XL2 , FFEE'-Oy 


3 
2 


H 
F 


2 

4 


DC H»32' _jBk 
DC FL3'32'~ yP^ 


2 

3 


P 
Z 


as needed 
as needed 


DC P'123' // 
DC PL4'123»-^ / 
DC Z'123' / 
DC ZL10'123'-/ 


2 

4 

3 

10 


E 
D 
L 


4 

8 

16 






Y 

A 


2 

4 


DC Y(HERE) 
DC AL1 (THERE) 


2 

1 


S 
V 
Q 


2 
4 
4 


- 




1 Depends on type 




2 Depends on whether or not an explicit length is spe 


cified in constant 
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ALIGNMENT OF CONSTANTS! The 
assembler aligns constants on 
different boundaries according to 
the following: 

On boundaries implicit to the type 
of constant, when no length 
specification is supplied. 

i On byte boundaries when an explicit 
length specification is made. 

Bytes that are skipped to align 
a constant at the proper boundary 
are not considered part of the 
constant. They are filled with 
zeros. Note that the automatic 
alignment of constants and areas 
does not occur if the NOALIGN 
assembler option has been specified 
in the job control language which 
invoked the assembler. 

NOTE: Alignment can be forced to 
any boundary by a preceding DS (or 
DC) instruction with a zero 
duplication factor (see G3N) . This 
occurs when either the ALIGN or 
NOALIGN option is set. 



Type of 
Constant 


Implicit 

Boundary 

Alignment 1 


Examples 


Boundary 
Alignment 


B 


byte 






C 


byte 






X 


byte 






H 


halfword 


DC H'25 1 

DC HL3'25' -v 


halfword 
byte 


F 


fullword 


DC F'225' \ 


fullword 






DC FL7'225' "X \ 


byte 


P 


byte 


DC P'2934' ^\_ 


byte 


Z 


byte 


DC Z'1235' Ijft 


byte 






DC ZL2'1235' -"^/J// 


byte 


E 


fullword 


DC E'1.25' /// 


fullword 






DC EL5'1.25' -/ / / 


byte 


D 


doubleward 


DC 8D'95' / / 


doubleword 






DC 8DL7'95' -J 1 


byte 


L 


doubleword 


DC L'2.57E65' / 


doubleword 


y 


halfword 


DC Y(HERE) / 


halfword 


A 


fullword 


DC AL 3 (THERE)-/ 


byte 


s 


halfword 






V 


fullword 






Q 


fullword 








Depends on type ■■ 
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Padding and Truncation of Values 



The nominal values specified fcr constants are assembled 
into storage. The amount of space available for the rcniral 
value of a constant is determined: 

1. Ey the explicit length specified in the second operand 
sufcfield, or 

2. If no explicit length is specified, by the implicit 
length according to the type of constant defined (see 
Appendix VI) . 



o 



PADDING; If more space is available 
than is needed to accommodate the 
binary representation of the nominal 
value, the extra space is padded: 



With binary zeros on the left for 
the binary (B) , hexadecimal (X) , 
fixed-point (H,F) , packed decimal 
(P) , and all address (A,Y,S,V,C) 
constants 

I With EBCDIC zeros en the left 
(X'FO 1 ) for the zoned decimal (Z) 
constants 

i With EBCDIC blanks en the right 

(X'40 1 ) for the character (C) 
constant 

NOTE: Floating-point constants 
(E,D,L) are also padded on the right 
with zeros (see G3I) . 



SB 

v 



Source Code 



DC BL2'101' 



DC XL3'FFA1 
DC X'FFA' 

DC H'255 1 
DC FL3'255' 

DC P'1234' 
DC PL4'123' 

DC AL3(512) 

DC ZL4'123' 
DC ZL4'3' 



DC C'FOUR' 
DC CL5'FOUR 
DC CL5'A' 



Object Code 



2 bytes 



0000000000000101 



Padding is on left 
for all constants 
except the charac- 
ter constant 



0FFA 



jOOOO FF 



loooo 



fooo 



1fofofo|c3 



Binary 
Digits 



Hexadecimal 
Digits 



fOOFFAll fxxl 

]-»W* 

1 byte 



OOFF 



r0 1234Cf ^-' > ' 



12 3C 



200 



JF0F1F2C31 



C6D6E4D9 



C6D6E4D940] 



Padding is on 
right for charac- 
ter constants 



rci40404040] 
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TRUNCATION: If less space is 
available than is needed to 
accommodate the nominal value, the 
nominal value is truncated and part 
of the constant is lest. Truncation 
of the nominal value is: 

On the left for the binary (B) , 
hexadecimal (X) , decimal {P and 
Z) , and address (A and Y) constants. 

On the right for the character (C) 
constant. 

! However, the fixed- point constants 
(H and F) will net be truncated, 
but flagged if significant bits 
would be lost through truncation. 

NOTE: Floating-point constants 
(E,E,L) are not truncated; they 
are rounded (see G3I) . 

NOTE: The above rules for padding 
and truncation also apply when the 
bit-length specification is used 
(see below under Subfield 3: 
Modifiers) . 



o 



Source Code 



DC BLI'OOOIOOOOIOI' 



Truncation 



Object Code 

1 byte 



00010000 



10l| . 



Binary 
Digits 



Truncation is on 
left for all constants 
except character 
constants 



DC XL3'FF11F0F0' 

DC PL2' 12345* 
DC ZL3'12345' 

DC AL2 (131072) 



FH11F0F0 



Hexadecimal 
Digits 



y 



12 3"45cf + fxxl 

F1F2 F3F4C5] j [« 
-£ 1 byte 



20000 



DC CL2'FOUR' 
DC CLl'ABCDE* 

DC H' 65531? 
DC FLl'128* 



o 



Truncation is on 
right for character 
constants 



C6D6E4D9 



rciC2C3C4C5 

■* * ERROR* * 
* * ERROR* * 



Nominal Values 
too large for 
space provided 



Subfield 1: Duplication Factor 



The duplication factor, if specified, 
causes the nominal value cr multiple 
nominal values specified in a 
constant to be generated the number 
of times indicated by the factor. 
It is applied after the nominal 
value or values are assembled into 
the constant. 

The factor can be specified by an 
i unsigned decimal self-defining term 

or by an absolute expression enclosed 
I in parentheses. 

The expression should have a positive 
value or be equal tc zero. 

Any symbols used in the expression 
roust be previously defined. 











Duplication 


SINGLE 
MULTIPLE 

EXPR 


DC 3H'240' 
DC 3FL1'3,4 

o 

DC (A-B+10- 


,5' 

3)A 


Object Code 
in hex 


|!Si!|00F0|00F0| 


O D 


|030405|O3Q4O5O3O4O5 


l(ADDR) 



%^ 



168 



o 



o 



© 



PageofGC33-4010-5 
As Updated 28 Dec 1 9 
By TNL GN20-9372 



NOTES: 

1 . The value of a location counter 
reference in a duplication factor is 
the value before any align to 
boundaries, according to the type of 
constant specified. 

2. A duplication factor of zero 
is permitted with the following 
results: * 

a. No value is assembled. 

I t. Alignment is forced according 
to the type of constant specified, 
if no length attribute is present 
(see above under Alignment of 
Constants) . 

c. The length attribute of the 
symbol naming the constant is 4fe 
established according to the ^^ 
I implicitly or explicitly specified 
length. 



3. If duplication is specified for 
an address constant containing a 
location counter reference, the 
value of the location counter 
reference is incremented by the 
length of the constant before each 
duplication is performed (for 
examples, see G3J) . 



ZERODUP DC OH' 3' 

L*ZER0DUP=2 



NOALIGN 



DC 




Halfword 
boundary 



0HL3'3' 
^Tl * NOAL 



N0ALIGN=3 



Subfield 2: Type 



The type subfield must be specified. 
It defines the type cf constant 
to be generated and is specified 
by a single letter cede as in the 
figure to the right. 

The type specification indicates 
to the assembler : 

1. How the nominal value (s) specified 
in subfield 1 is to be assembled; 
that is, which binary representation 
or machine format the object code 

of the constant must have . 

2. At what boundary the assembler 
aligns the constant, if no length 
specification is present. 

3. How much storage the constant 
is to occupy, according to the 
implicit length of the constant, 

if no explicit length specification 
is present (for details see above, 
under Padding and Truncation of 
Constants) . 



Code 



Type of Constant 



Character 
Hexadecimal 
Binary 
Fixed-point 

Fixed-point 

Floating-point 

Floating-point 

Floating-point 

Decimal 
Decimal 
Address 
Address 
Address 

Address 




Machine Format 



8-bit code for each Character 

4-bit code for each hexadecimal digit 

Binary format 

Signed, fixed-point binary format; 

normally a fullword 
Signed, fixed-point binary format; 

normally a halfword 
Short floating-point format ; normally a 

fullword 
Long floating-point format; normally a 

doubleword 
Extended floating-point format; normally 

two doublewords 
Packed decimal format 
Zoned decimal format 
Value of address; normally a fullword 
Value of address; normally a halfword 
Base register and displacement value; 

a halfword 
Space reserved for external symbol 

addresses; each address normally a 

fullword 
Space rasenwd for external dummy section 

offiet 



Object Code 
in hex 



Examples: 



DC P'+234' 
DC C'ABC 
DC X'FO' 
DC H'2' 



234C 



C1C2C3 
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Subfield 3; Modifiers 



The three modifiers that can be 
specified tc describe a constant 
are : 

^p The length modifier (L) , which 
^^ explicitly defines the length in 
bytes desired for a constant. 

OThe scale modifier (S) , which is 
only used with the fixed-point or 
floatingpoint constants (for details 
see below under Scale Modifier) . 

^^The exponent modifier (E) , that 
^^ is only used with fixed-point or 
floating-point constants, and which 
indicates the power of 10 by which 
the constant is to be multiplied 
before conversion to its internal 
binary format. 

^^ If multiple modifiers are used, 
^^ they must appear in the sequence: 
length, scale, exponent. 

LENGTH MODIFIER: The length modifier 
indicates the number of bytes of 
storage into which the constant 
is to be assembled. It is written 
as Ln, where n is either cf the 
following: 

^9 A decimal self-defining term 

OAn absolute expression enclosed 
in parentheses. It must have a 
©positive value and any symbols it 
contains must be previously defined. 

DOS/ NOTE: Location counter reference 
vs must not be used in the modifier 

subfield » 







o 




LENGTH 


DC 


XLIO'FF' 




SCALE 


DC 


FS8'35.92' 

e 




EXPON 


DC 


EE3» 3.414' 

o 




ALL3 


DC 


DL7S3£50.* 2.7182' 

o 





b — V) 











Length 


DECSDT 
EXPR 


DC 
DC 


o 

FL3'9999' 


e 




XL (SYMBOL- 


-ADDR+3= 


^B-L^D) 'F7A' 



170 



o 






When the length modifier is 
specified; 

Its value determines the number 
of bytes of storage allocated to 
a constant. It therefore determines 
Whether the nominal value of a 
constant must be padded or truncated 
to fit into the space allocated 
(see above under Padding and 
Truncation of Constants) . 

i No boundary alignment, according 
to constant type, is provided (see 
above under Alignment of Constants) . 

(Its value must not exceed the maximum 
length allowed for the various types 
of constant defined. (For the 
allowable range of length modifiers, 
see the specifications for the 
individual constants and areas from 
G3C through G3N.) 



Source Code 



PADTRUNC DC CL^'ABCDE' 



o 

L3'i 



Object Code 
in hex 



Two bytes 
truncated 




C1C2C 




IMPLICIT DC d^CDE' 



For character constant: when no 
length is specified, the whole con- 
stant is assembled into its implicit 
length 



C1C2C3C4C51 



NOALIGN DC FL3'513' 



Assembled at the next 
available (byte) boundary 



« 



Fullword 
boundary 



000201 



TOOLONG DC FL9'10' ** LENGTH ERROR** 

© 
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BIT-IENGTH SPECIFICATION; The length modifier can be 
specified tc indicate the number cf bits intc which a 
constant is to be assembled. The bit-length specification 
is written as L.n, where n is either of the following: 

A decimal self-defining term 

An absolute expression enclosed in parentheses. It must 
have a positive value and any symbcis it contains must 
be previously defined. 

The value of n must lie between 1 and the number cf bits 
(a multiple of 8) that are required to make up the maximum 
number of bytes allowed in the type of constant being 
defined. The bit length-specification cannot be used with 
the S, V, and £-type constants. 



O 



© 



When only one operand and one nominal 
value are specified in a EC 
instruction, the following rules 
apply: 

1. The bit- length specification 
allocates a field intc which a 
constant is to be assembled. 

The field starts at a byte boundary, 
and can run over one or more byte" 
boundaries , if the bit- length 
specified is greater than 8. 

If the field does not end at a byte 
boundary, if the bit-length specified 
is not a multiple of 8, the remainder 
of the last byte is filled with 
zeros. 



Source Code 



HEXCHAR DC XL.4»F' 



Object Code 

Binary digits 



byte 



byte 



liiiiit 

■ '■ " ■ —WW— 




filll 



HEX3CHAR DC XL.12'FFF' 



byte 



byte 



|byte 



11111111 



liiiiii 



FFFk 

o o 



W 
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2. The nominal value cf the constant 
is assembled into the field: 

Starting at the high order end for 
the C, E r D, and L type constants. 

Starting at the low order end for 
the remaining types of constants 
that allow bit- length specification. 

The nominal value is padded or 
truncated to fit the field (see 
above under Padding or Truncation 
of Constants) . 

Padding of character constants is 
with hexadecimal blanks, X'W; 
other constant types are padded 
with zeros. 

NOTE: The length attribute value 
of the symbol naming a DC instruction 
with a specified bit- length is equal 
to the minimum number of integral 
bytes needed to contain the bit- 
length specified for the constant. 
L* TRUNCF is equal to 2a Thus r a 
reference to TRUNCF would address 
the entire two bytes that are 
assembled. 



Source Code 



Object code 
binary digits 



o 

PADC DC CL.ll'A' padding 

byte WM byte Jit 



=X'40' 





oiolooooo 



Truncation < 
blank at right 



Filled with 
zeros 



PADF DC FL.13'579' 

b Vte fi e | d byte 



00( 




byte? 



Padding by 
zeros at left 



TRUNCC DC CL.ll'AB' 



b V te field byte T byte 



Truncation of B 
at right 




000000 



TRUNCF DC FL.13'8193 1 



10000000000001000 




5 



First 13 bits 
of 8193 



Truncation at 
left 



II ooooooooooooii A 



8193| 
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When irore than cne cperand is 
specified in a EC instruction or 
more than cne nominal value in a 
EC operand, the above rules atout 
bit-length specifications also 
apply* except: 

1. The first field allocated starts 
at a byte boundary , but the 
succeeding fields start at the next 
available bit . 

2. After all the constants have 
been assembled intc their respective 
fields, the bits remaining to make 
up the last byte are filled with 
zeros . 

NOTE: If duplication is specified, 
filling with zeros occurs once at 
the end of all the fields occupied 
by the duplicated constants. 

3. The length attribute value of 
the symbol naming the EC instruction 
is equal to the number of integral 
bytes that would be needed to contain 
the bit-length specified for the 
first constant tc be assembled. 



Source 
Code 



L'VALUES=2 



VALUES DC FL. 10' 161, 21 ,57' 



byte 



byte 



byte byte 



byte 



Object 
Code 



>r>- 


- Padding — 






,..\ . 






OjlGiaOfl &|0 0& 8103|O 000 HIOQllO 




. H 


1 — u — | 


Fill 

© 



161 



QD O 



Source 
Code 



L'OPERANDS=l 



OPERANDS DC FL. 7 ' 8' ,CL. 10 ' AB ' ,XL .14 'C4 ' 



byte 




byte byte 



byte 



Padding 



Object 
Code 



oo olioooji loooooili Ijooooo objioooioolo 




X'C4' 1 



Truncation of 
B at right 






Wj^' 
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e 
e 

o 



STORAGE REQUIREMENT FOR CONSTANTS; 
The total amount of storage required 
to assemble a DC instruction is 
the sum of : 

1. The requirements for the 
individual DC operands specified 
in the instruction. 

The requirement of a DC operand 
is the product of: w 

a. The length (implicit or 
explicit) , 

b. The number of nominal values , 
and 

c. The duplication factor , if 
specified. 



2. The number of bytes skipped 
for the boundary alignment between 
different operands. 



SPACE DC 10H' 
Space for 



o 
e 



OPERAND 1 
OPERAND 2 

ALIGNMENT 



3,4,5' ,10FL3'6,7,8' 
Storage Regit irements 

a x it* x 10 = 60 

$ x $ x 10 = 90 

o o o 



Second operand not 
aligned due to presence 
of length specification 



TOTAL |150| 



ALIGN DC C'ABC ,F'9,10,11' 



o 

© 



OPERAND 1 
OPERAND 2 

ALIGNMENT 



Bytes 



ooo 

3 x j|:: Jkr...i) = 3 

* x liiPll! = 12 



.0-3 



First operand can 
end on any byte 
boundary 



TOTAL 1 15-18 



Bytes 



SCALE MODIFIER; The scale modifier 
specifies the amount cf internal 
scaling that is desired: 

Binary digits for fixed- point (H,F) 
constants 

Hexadecimal digits fcr floating- 
point (E,D,L) constants 

it can only be used with the above 
types of constant. 

The scale modifier is written as 
jSn, where n is either: 

^m A decimal self-defining term or 

©An absolute expression enclosed 
in parentheses. 

DOS Any symbols used in titfK#aqpr**j»lcm 
Inst be previously defined. 

Both types of specification can 
be preceded by a sign; if no sign 
is present, a plus sign is assumed. 











^^^^^^^^^^H 


Exar 

DC 
DC 
DC 

DC 
DC 


nples: 

o 


Allowable Range for 
Scale Modifier 


HS-132 , 5.55' 
HS3'2.25J £ 


.3' 


Fixed-point 
Constants 

(H,F) 


- 187 

through 
■+346 


FS(A+B-C*3) '2 




Floating-point 
Constants 




ESl2'19.3 f 
LS22'3.414' 




(E,D) 
(L) 


through 14 


through 28 
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SCALE MODIFIER FOR FIXED-POINT 
CONSTANTS: The scale modifier for 
fixed-point constants specifies 
the power of two by which the fixed- 
point constant must be multiplied 
after its nominal value has been 
converted to its binary 
representation, but before it is 
assembled in its final "scaled" 
form. Scaling causes the binary 
point to move from its assumed fixed 
position at the right of the 
rightmost bit position. 



DC H'2 




Object Code 

Binary digits 

ooooooodooooooio 



> ok 



0000000 



opoooiooo 



T 



DC HS+2 



00000000 



00000000 



00001001 



LUU1 • 

r 



00001001 






176 






BOTES: 

1. When the scale ircdifier has a 
positive value, it indicates the 
number of binary positions to te 
occupied by the fractional pcrticn 
of the binary number. 

2. When the scale ircdifier has a 
negative value, it indicates the 
number of binary positions to te 
deleted from the integer portion 
of the binary number. 

3. When positions are lest because 
of scaling (or lack of scaling) , 
rounding occurs in the leftmost- 
tit of the lest pcrticn. The 
rounding is reflected in the 
rightmost pesitien saved. 



Source Code Object Code 



Converted to Binary Bfnary digits 

Representation 




0000000010001000 



DC v HS+4 'm*®! 

Asembled Constant 



ooooooooioootood 



Binary 
point 



Converted to Binary representation 



DC.HS-Z'fc, 




10 



Binary 
point 



001001 



© 

ooooooooiooooooioill 



Converted to Binary representation 



DCtHS-2 1 





00000000P0000011 



Converted to Binary representation 



DC.HlLi 




100011 



000000000000100111 



Binary 
point 
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SCALE MODIFIER FOR FLOATING-POINT 
CONSTANTS : The scale modifier for 
floating-point constants irust have 
a positive value. It specifies 
the number of hexadecimal positions 
that the fractional portion of the 
binary representation cf a floating- 
point constant is to be shifted 
to the right. The hexadecimal point 
is assumed to be fixed at the left 
of the leftmost position in the 
fractional field. When scaling 
is specified, it causes an 
unnormalized hexadecimal fraction 
to be assembled (unnormalized is 
when the leftmost positions of the 
fraction contain hexadecimal zeros) . 
The magnitude of the constant is 
retained because the exponent in 
the characteristic portion of the 
constant is adjusted upward 
accordingly. When hexadecimal 

.positions are lost, rounding occurs 
in the leftmost hexadecimal position 
of the lost portion. The rounding 
is reflected in the rightmost 

^position saved. 



Source Code 



DC E'4' 



DC ES2'4 



DC E'3.3 



Object Code 
in Hex 




41 


400000 






A 






Cf 




Normalized 
Fraction " 


A 




V 





4 3|0|0{4 000 



Unnormalized 
Fraction 



|4l|34CCCDl 



ROUND DC ES2'3.3' l43j0034CD} CD 



© 






S «W ; 



EXPONENT MODIFIER: The exponent 
modifier specifies the power of 
10 by which the nominal value cf 
a constant is to be multiplied 
before it is converted to its 
internal binary representation* 
It can only be used with the fixed- 
point (H,F) and floating-point 
(E,D,L) constants. The exponent 
modifier is written as En, where 
n can be either of the following: 

O A decimal self-defining term. 

OAn absolute expression enclosed 
in parentheses. 

DOS Any symbols used in the expression 
must be previously defined. 

The decimal self-defining term or 

©the expression can be preceded by 
a sign: if no sign is present, a 
plus sign is assumed. The range 
for the exponent modifier is -85 
through +75. 







Exponent 


Source 
Code 


Decimal Value 
before conver- 
sion to binary 
form 


Object Code 

Binary digits 


DC H'4' 

o 

DC HE2'4' 

e 


4 
400 

_ 
4 




0000000000000100 




0000000110010000 




DC FE(A-B*3) '4' 

© 

DC HE-2'400' 


0000000000000100 
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O 



o 
© 

o 



NOTES: 

1. The exponent modifier is not 
to be confused with the exponent 
that can be specified in the nominal 
value subfield of fixed-point and 
floating-point constants (see 
sections G3G and G3I) . 

The exponent modifier affects each 
nominal value specified in the 
operand, whereas the exponent written 
as part of the nominal value subfield 
only affects the nominal value it 
follows. If both types of exponent 
specification are present in a DC 
operand, their values are 
algebraically added together before 
the nominal value is converted to 
binary form. However, this sum 
must lie within the permissible 
range -85 through +75. 

2. The value of the constant , after 
any exponents have been applied, 
must be contained in the implicitly 
or explicitly specified length of 
the constant to be assembled. 



Subfield M: Nominal Value 



The nominal value subfield must 
always be specified. It defines 
the value of the constant (or 
constants) described and affected 
by the subfields that precede it. 
It is this value that is assembled 
into the internal binary 
representation of the constant. 
The formats for specifying nominal 
values are described in the figure 
to the right. 

Only one nominal value is allowed 
in binary (B) and hexadecimal iX) 
constants. 

How nominal values are specified 
and interpreted by the assembler 
is explained in the subsections 
that describe each individual 
constant, beginning at G3D 



DC E'2.25E+2,2.25 / 225E-2 t 
DC EE+2'2.25,2.25,225' 



DC FE+2 , 2.25E+2,2.25,2.25,22500E-4' 



Values Assembled 
in decimal 



225,2.25,2.25 



225,225,22500 












Norn. Value 


Constant 
Type 


Formats of Nominal 
Vafue Subfields 


Single 

Nominal 

Values 


Multiple 
Nominal 
Values 


C 


'Value' 


Not allowed 


Ef 

X 

H 
F 

P 

Z 
E 
D 


► 


'Value' 








nultiple values must 
be separated by commas 




\ 




A 
Y 
S 
Q 

V 

> 


Address 
•Constants 


(Value) 


(Value, value, value) 
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G3C — LITERAL CONSTANTS 



Purpose 



Literal constants allow you to 
define and refer to data directly 
in machine instruction operands. 
You do not need to define a constant 
separately in another part of your 
source module. The difference 
between a literal, a data constant, 
and a self-defining term is described 
in C5. 



Specifications 



A literal constant is specified 
in the same way as the operand of 
a DC instruction. The general rules 
for the operand subfields of a DC 
instruction (as described in G3E 
above) also apply tc the subfield 
of a literal constant. Moreover, 
the rules that apply to the 
individual types of constants, as 
described in G3D through G3M, apply 
to literal constants. 

However, literal constants differ 
from DC operands in the following 
ways : 

O* Literals must be preceded by an 
equal sign. 

f% • Multiple operands are not allowed. 

©• The duplication factor must not 
be zero. 



wee not alldsr### " >; ; - V- , •;• *; 



w 



o 

L 3,=F'32' 



LM 3,5,=A(BASE,BASE+4096,BASE+8192) 



WfM Multiple Nominal 
^^ Values are allowed 
MVC FIELD ( 24 ) ,=6CL4' CANT' 



c 
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Data Constants 



G3C — BINARY CONSTANT (B) 
Furpcse 



The binary constant allows ycu tc specify the precise bit 
pattern ycu want assembled into storage. 

Specifications 



The constants of the sufcfields defining a binary constant 
are described in the figure below. 

NOTI: Each binary constant is assembled into the integral 
number of bytes required to contain the tits specified. 



■f*\ 



Subfield 



1. Duplication Factor 
allowed 



2. Modifiers 

Implicit Length: (Length 
Modifier not present) 



Alignment: 

(Length Modifier not present) 



Range for Length* 



Range for Scale: 



Range for Exponent: 



4. Nominal Value 
Represented by: 



Enclosed by: 



Exponent allowed: 



Number of Values per 
Operand: 



Padding: 



Truncation of 
Assembled Value : 



Binary Constants 



3. Constant Type 



Binary (B) 



Yes 



As needed 

B DC B'lOlOllll' 

C DC B'101' 



Byte 



1 through 256 (byte length) 
.1 through .2048 (bit length) 



Not allowed 



Not allowed 



Binary digits 
(0or1) 



Apostrophes 



No 



Multiple 



0&ft>m 



With zeros 
at left 



At left 



L'B = 1 
L'C = 1 



*> 
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G3E — CHARACTER CONSTANT (C) 
Furpcse 



The character constant allows ycu tc specify character 
strings such as error messages, identifiers, or ether text, 
that the assembler will convert into their binary (EECEIC) 
representation . 



Specifications 



The contents of the subfields defining a character ccr.stant 
are described in the figure en the eppesite page. 

Each character specified in the ncirinal value subfield 
is assembled into one byte. 

Multiple nominal values axe net allowed, because if a comma 
is specified in the nominal value subfield, the assembler 
considers the comma a valid character and therefore ,, 
assembles it intc its binary (EBCDIC) representation. 

NOTE: When apostrophes or ampersands are to be included 
in the assembled censtant, double apostrophes or dcuble 
ampersands must be specified. They are assembled as single 
apostrophes and ampersands. 



W^ 



\J 
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o 













Subfield 


Character Constants 




3. Constant Type 


1. Duplication Factor 
allowed 


Character (C) •* 


Yes 






2. Modifiers 

Implicit Length: (Length 
Modifier not present) 


As needed 

C DC C LENGTH' 

o 


L'C = 6 




Alignment: 

(Length Modifier not "su 
present) 


Byte 






Range for length: 


1 through 256 (byte length) 
.1 through .2048 (bit length) 






Range for Scale: 


Not allowed 






Range for Exponent: 


Not allowed 






4. Nominal Value 
Represented by: 


Characters (All 256 
8-bit combinations) 


DC C'A' 'B' 

L J A'B A 


Object Code (hex). 


IC1I7DIC2I 


"*"""""•" A&B ^iP 
DC CA&&B' 


|C1|50 C2| 




Enclosed by: 


Apost rophes 






Exponent allowed: 


Mkv, 






Number of values per 
Operand: 


One 


DC C'A,B* 

Assembled A , B U% 




|C1|6B|C2| 

/ 


^ 




Padding: 


With blanks at right 
(X'40*) 






Truncation of 
Assembled value: 


At right 
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G3F — HEXAEECIMAI CCNSTAKT (X) 



Eurpcse 



/4~^\ 



You can use hexadecimal constants to generate large tit 
patterns rtore conveniently than with binary constants. 
Also, the hexadecimal values you specify in a source ncdule 
allow ycu tc compare their directly with the hexadecimal 
values generated for the object code and address locations 
printed in the prcgrair listing. 



Specificaticns 



The contents of the subfields defining a hexadeciiral 
constant are described in the figure on the opposite page. 

Each hexadecimal digit specified in the nominal value 
subfield is assembled intc four bits (their binary patterns 
can be found in C4E) . The implicit length in bytes cf a 
hexadecimal constant is then half the number of hexadecimal 
digits specified (assuming that a hexadeciiral zerc is added 
to an odd number cf digits) . 



H^r' 



c 
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Subfield 


Hexadecimal Constants 




3. Constant Type 


1. Duplication Factor 
allowed 


Hexadecimal (X) 


■4 






Yes 








2.Modifiers 

Implicit Length: (Length 

Modifier not present) 


As needed 

X DC X'FF00A2' 
Y DC X'F00A2' 


L'X = 3 — ~£% 
L'Y = 3 — ^r 




Alignment: 

(Length Modifier not present) 


Byte 






Range for Length: 


1 through 256 (byte length)* 
.1 through .2048 (bit length) 






Range for Scale: 


Not allowed 






Range for Exponent: 


Not allowed 


o 




4. Nominal Value 
Represented by: 


Hexadecimal digits (0 
through 9 and A through 
F) 


DC X'lF' 


Object Code (hex) 






0001 1111 




DC X'91F' 0000 1001 


OOOllllll 






*— 1 byte — a* 


Enclosed by: 


Apostrophes 


O 




Exponent allowed: 


No/ 






Number of Values 
per Operand: 


». .*• . Gn*y <*» 
Multiple '^ 






Padding: 


With zeros at left 






Truncation of 
Assembled value: 


At left 







c 
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G3G — FIXEC- POINT CONSTANTS (K ANE F) ,f X 

Purpose 



Fixed-point constants allow you to introduce data that 
is in a fcrir suitable fcr the operations cf the fixed-point 
irachine instructions of the standard instruction set. 
The constants you define can alsc be automatically aligned 
to the proper fullword or halfword boundary for the 
instructions that refer tc addresses on these boundaries 
(unless the NCALGN option has been specified; see E2) . 
You can perform algebraic functions using this type of 
constant because they can have positive or negative values. 

Specifications 

The contents cf the subfields defining fixed-point constants 
are described in the figure on the opposite page. 

^P The nominal value can be a signed (plus is assumed if they 

O number is unsigned) integer , fraction , or mixed number £% 
followed by an exponent (positive or negative) . The ^^ 
©exponent must lie within the permissible range. If an 
exponent modifier (see G3E) is alsc specified, the algebraic 
sum cf the exponent and the exponent modifier must lie £k 
within the permissible range. ^"J 



Ly 
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H or F 


Subfield 


Fixed-Point Constants 




3. Constant Type 


1. Duplication Factor 
Allowed 


Fullword(F) 


Halfword (H) 




Yes 


Yes 




2. Modifiers 

Implicit Length: (Length 
Modifier not present) 


4 bytes 


2 bytes 




Alignment: 

(Length Modifer not present) 


Full word 


Half word 




Range for Length: 


1 through 8 (byte length) 
.1 through .64 (bit length) 


1 through 8 (byte length) 
.1 through .64 (bit length) 




Range for Scale: 


- 187 through + 346 


- 187 through + 346 




Range for Exponent: 


- 85 through + 75 ^k 


- 85 through + 75 DC HE+90'2E-88* 
value = 2xl0 2 ^!k 


4. Nominal Value 
Represented by: 


Decimal digits (0 through 9) 

DC F'-200' V 
DC FS4'2.25' Q 


Decimal digits (0 through 9) 

DC H'+200' 
DC HS4' .25' 




Enclosed by: 


Apostrophes 


Apostrophes 




Exponent allowed: 


Yes 

DC/-F « 2E6 ' A 


Yes 

DC H *2E-6' 




Number of Values 
per Operand: 


Multiple 


Multiple 




Padding: 


With zeros at left 


With zeros at left 




Truncation of 
Assembled value: 


Not allowed 

(error mes. 


Not allowed 

sage issued) 
i 
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Some examples of the range of values 
that can be assembled into fixed- 
point constants are given in the 
figure to the right. 

The range of values depends on the 
implicitly or explicitly specified 
length (if scaling is disregarded) . 
If the value specified for a 
particular constant does not lie 
within the allowable range for a 
given length, the constant is not 
assembled but flagged as an error. 



Length 

o 


Range of Value* that 
can be Assembled 


8 
4 
2 
1 


-2 63 through 2 63 -l 
_ 2 31 „ 2 31 -;L 

-a" - 2 15 -i 

-2 7 " 2 7 -l 






A fixed-point constant is assembled as fellows: 

1. The specified number, multiplied by any exponents, 
is converted to a binary number. 

2. Scaling (see G3E) is perfcrired, if specified. If a 
scale modifier is not provided the fractional portion cf 
the number is lost. 

3. The binary value is rcunded, if necessary. The 
resulting number will not differ from the exact nuirter 
specified by irere than cne in the least significant bit 
position at the right. 

4. A negative nuirber is carried in 2's complement form. 

5. Duplication is applied after the constant has been 
assembled. 



G3H — DECIMAL CONSTANTS (P AND Z) 
Purpose 



• 



Vv' 



The decimal constants allow ycu tc introduce data that 
is in a form suitable for the operations of the decimal 
feature machine instructions. The packed decimal constants 

(P-type) are used for processing by the decimal instruction 
set. The zened decimal constants (Z-type) are in the form 

(EBCDIC representation) that you can use as a print image 

(except the digits in the rightmost tyte) . 

Specifications 



The contents cf the sufcfields defining decimal constants 
are described in the figure on the opposite page. 

Ihe nominal value can be a signed (plus is assumed if the 
number is unsigned) decimal number. A decifmal point can 
be written anywhere in the number, tut it does net affect 

Othe assembly of the constant in any way. The specified 
digits are assumed tc constitute an integer. Decimal 
constants are assembled as follows: 

A PACKED DECIEAI CONSTANTS: Each digit is converted into -^ 

^P its 1-bit binary eguivalent. The sign indicator is ^p 

assembled into the rightmost four bits of the constant. 

^^ ZONED DECIMAL CONSTANTS: Each digit is converted intc ^ 
^pits 8-bit EECDIC representation. The sign indicator ^p 

replaces the first fcur bits cf the low-crder byte of the 

constant. 
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PorZ 1 


Subfieid 


Decimal Constants 


3. Constant Type 


1. Duplication Factor 
Allowed 


Packed (P) 


Zoned (Z) 




Yes 


Yes 




2. Modifiers 

Implicit Length: (Length 
Modifier not present) 


As needed 

P DC P'+593' 

L'P = 2 


As needed 

Z DC Z'-593' 

L'Z = 3 




Alignment: 

(Length Modifer not present) 


Byte 


Byte 




Range for Length: 


1 through 16 (byte length) 
.1 through .128 (bit length) 


1 through 16 (byte length) 
,1 through .128 (bit length) 




Range for Scale: 


Not allowed 


Not allowed 




Range for Exponent: 


Not allowed 


Not allowed 




4. Nominal Value 


Decimal digits (0 through 9) 

DC P'+555' 


Decimal digits (0 through 9) 
DC Z'-455' 


DC P'5.5 1 


Represented by: fjj 


5 5\CfQ 




1 5 | 5 | 5 | C [ftp 


DC P'55' 




O |F|5|F|5|D|5| 


Enclosed by: 


Apostrophes 


Apostrophes ^m 




Exponent allowed : 


No 


No 




Number of Values 
per Operand: 


Multiple 


Multiple 




Padding: 


With Binary zeros 
at left 


With EBCDIC zeros 

(X'FO') 

at left 




Truncation of 
Assembled value: 


At left 


At left 





4% 
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The range of values that can be 
assembled into a deciical constant 
is shown in the figure to the right. 



Type of Decimal 
Constant 


Range of Values that 
can be Specified 


PACKED 


10 31 -1 through -10 31 


ZONED 


10 16 -1 through -10 16 






G3I — FLOATING-POINT CONSTANTS (E , D, and I) 



Furpcse 



Floating-point constants allow you to introduce data that 
is in a fcrir suitable fcr the operations cf the floating- 
point feature instruction set. These constants have the 
following advantages ever fixed-pcint constants. 

1. Ycu do net have to consider the fractional pcrticn cf 
a value ycu specify* ncr worry afceut the position cf the 
deciital point when algebraic operations are to be performed. 

2. Ycu can specify both much larger and rruch smaller values. 

3. You retain greater processing precision, that is, ycur 
values are carried in more significant figures. 



V_V 



Specifications 



The contents of the subfields defining f loating-pcint 
constants are described in the figure en the opposite page. 

^P The nominal value can be a signed (plus is assumed if the 
number is unsigned) integer", fraction, cr mixed number ^fr 

O followed by an exponent (positive or negative) . The ^^ 
exponent must lie within the permissible range. If ar 
exponent modifier (see G3E under Modifiers ) is also 
specified, the algebraic sum of the exponent and the 
exponent modifier must lie within the permissible range. 



190 



c 











D, E or L 1 


Subfield 


Floating Point Constants 


3. Constant Type 


1. Duplication Factor 
Allowed 


SHORT (E) 


LONG (D) 


EXTENDED (L) 


Yes 


Yes 


Yes 


2. Modifiers 

Implicit Length: 
(Length Modifier Not 
Precent) 


4 Bytes 


8 Bytes 


16 Bytes 


Alignment: 
(Length Modifier Not 
Present) 


Full Word 


Double Word 


Double Word 


Range for Length: 


1 through 8 (byte length) 
.1 through .64 (bit length) 


1 through 8 (byte length) 
.1 through .64 (bit length) 


1 through 16 (byte length) 
.1 through .128 (bit length) 


Range for Scale: 


through 14 


through 14 


through 28 


Range for Exponent: 


- 85 through + 75 


- 85 through + 75 


- 85 through + 75 


4. Nominal Value 
Represented by: 


Decimal Digits ^_ 

(0 through 9) ^-MM— — 

DC E'+525' ^ 
DC E'5.25' A 


Decimal Digits 
( through 9) 

^DCIV^S' 

dc D' + .ooi' wk 


Decimal Digits 
( through 9) 

DC L'525 1 

DC L'3.414' A 


Enclosed by: 


Apostrophes 


Apostrophes 


Apostrophes 


Exponent Allowed: 


Yes 

DC E»lE+60' A 


Yes 

DC D'-2.5E10*A 


Yes ^9 

DC L'3.712E-3' 


Number of Values per 
Operand : 


Multiple 


Multiple 


Multiple 


Padding: 


With hexadecimal zeros at 
right 


With hexadecimal zeros at 
right 


With hexadecimal zeros at 
right 


Truncation of Assembled 
Value: 


Not applicable 
(Values are rounded) 


Not Applicable 
(Values are Rounded) 


Not applicable 
(Values are Rounded) 
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The range of values that can be 
assembled into floating-point 
constants is given in the figure 
to the right. 

If the value specified for a 
particular constant does not lie 
within these ranges, the constant 
is not assembled but flagged as 
an error. 



Type of 
Constant 


Range of Magnitude (M) 
of Values (Positive and 
Negative) 


E 
D 
L 


16" 65 <M<(1-16" 6 ) x 16 63 
16" 65 <M<(1-16" 14 ) x 16 63 
16~ 65 <M <(1-16" 28 ) x 16 63 




(For all Three) 
Approximately 

5.4 x 10~ 79 <M <7.2 x 10 75 



FORMAT; The format of the floating- 
point constants is described below. 
The value of the constant is 
represented by two parts: 

^m 1. An exponent portion , followed 
by 

^P 2. A fractional portion. 

^M A sign bit indicates whether a 
positive or negative number has 
been specified. The number specified 
must first be converted into a 
hexadecimal fraction, before it 
can be assembled into the proper 
internal format. The quantity 

©expressed is the product of the 
fraction and the number 16 raised j% 
to a power. 1m 



Type 



Called 



Format 



Short 
Floating- 
Point 
Number 



Long 
Floating- 
Point 
Number 



Extended 
Floating- 
Point 
Number 




Bits 1 



78 



7-bit 
+ Characteristic 



Bits 1 



78 



7-bit 
+ Characteristic 



Bits 01 



Bits 1 



» ■ 

o o 

\ Characteristic 1 1 He> 



31 



56-bit 
Fraction 

I3CZIZZ3I1 



63 



High-order half of 
112-bit Fraction 




Hexadecimal Fraction 



16' 



ti + iViV""] 



where a,b,c. ... are hexadecimal digits, and E is 
an exponent that has a positive or negative value 
indicated by the characteristic 
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BINARY REPRESENTATION : The assembler 
assembles a floating-point constant 
into its binary representation as 
follows: 

The specified number, multiplied 
by any exponents, is converted to 
the required two-part format. The 
value is translated intc: 

1. A fractional portion represented^ 
by hexadecimal digits and the sign 
indicator. The fraction is then 
entered into the leftmost part of 
the fraction field of the constant 

(after rounding) . 

2. An exponent portion represented 
by the excess 64 binary notation, 
which is then entered into the 
characteristic field of the constant. 

The excess 64 binary notation is 
when the value of the characteristic 
between +127 and +64 represents 
the exponents of 16 between +63 
and (by subtracting 64 J and the 
value of the characteristic between 
♦63 and represents the exponents 
of 16 between -1 and -64. 

NOTES: 

1. The L-type floating-point, constant 
resembles two contiguous D-type 
constants. The sign of the second 
doubleword is assumed to be the 

same as the sign of the first. 

The characteristic for the second 
doubleword is equal to the 
characteristic of the first 
doubleword minus 14 (the number 
of hexadecimal digits in the 
fractional portion of the first 
doubleword) . 

2. If scaling has been specified, 
hexadecimal zeros are added to the 
left of the normalized fraction 

(causing it to become unnormalized) 
and the exponent in the 
characteristic field is adjusted 
accordingly. (For further details 
on scaling see G3E under Modifiers ) . 

3. Rounding of the fraction is 
performed according tc the implicit 
or explicit length of the constant. 
The resulting number will not differ 
from the exact number specified 

by more than one in the last place. 

4. Negative fractions are carried 
in true representation, net in the 
2 f s complement form. 

5. Duplication is applied after 
the constant has been assembled. 



Binary Representation 



Source Code 



DC D'-9.75' 



Object Code 
in Hex 







= - 9.75 



Hexadecinaai 



7F 
7E 



o@ 



oo 



Decimal 



127 ) 
126 



65 
6* 
63 
62 



> -64 



Values Expressed 
in Characteristic 



V Decimal 



-4<63 




-1 
- 2 



-64 



Exponent of 16 
expressed by 
Characteristic 



Excess 64 Binary Notation 
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G3J — THE A-TYPE AND Y-TYPE ADDRESS CCKSTANTS 



This subsection and the three following subsections describe 
how the different types cf address constants are assembled 
from expressions that usually represent storage addresses, 
and hew the constants are used for addressing within ard 
between source ircdules. 



Purpose 



In the A-type and Y-type address constant, ycu can specify 
any cf the three types of assembly-time expressions (see 
C6) , whose value the assembler then coirputes and assembles 
into object code. You use this expression ccirputaticr 
as fellows: 

1. Relocatable expressions for addressing 

2. Absolute expressions for addressing and value 
computation. 

3. Ccirplex relocatable expressions to relate addresses f 
in different source ircdules. 



Specificaticns 



The contents cf the subfields defining the A-type and Y- 
type address constants are described in the figure on the 
opposite page. 



\t- 



e 



NOTES: 

1. Kc bit-length specification is allowed when a relocatable 
or coirplex relocatable expression is specified. The enly 
explicit lengths that can be specified with these addresses 
are: 

a. 3 cr 4 bytes for A-type constants 

b. 2 bytes for Y-type constants. 

2. The value of the lecatien counter reference (*) when 
specified in an address constant varies from constant tc 
constant, if any cf the fcllcwing cr a ccrrbination of the 
following are specified: 

a. Multiple operands 

b. Multiple ncirinal values 

c. A duplication factor. 

The location counter is incremented with the length cf 
the previously assembled constant. 

3. When the location counter reference occurs in a literal 

address constant, the value of the location counter is x 

the address of the first byte of the instruction. /j 



js 



194 



Address Constants 



c 









A or Y 


Subfield 


Address Constants (A and Y) 


3. Constant Type 


1. Duplication Factor 
allowed 


A - Type 


Y - Type 


O 


Yes 


Yes A DC 

Ohiect Code in Hex ». 0001 


5AL1(*-A) 
020304 




2. Modifiers 

Implicit Length: (Length 
Modifer not present) 


4 bytes 


2 bytes 




Alignment: 

(Length Modifier not present) 


Full word 

m 


Half word 
\ 




Range for Length: 

/- 


1 through 4 (byte length) ^1 
.1 through .32 (bit length) 


* 1 through 2 (byte length) 
.1 through .16 (bit length) 




Range for Scale: 


Not allowed 


Not allowed 




Range for Exponent: 


Not allowed 


Not allowed 




4. Nominal Value 
Represented by: 


Absolute, relocatable, or"j 
complex relocatable Lm 
expressions J ^ 
DC A(ABSOL+10) 


f Absolute, relocatable, or 
|| complex relocatable ^ pc 
I expressions 
DC Y(RELOC+32) 


© 

Y(*-A,*+4) 

it¥€ 
values 


Enclosed by: 


Parentheses 


Parentheses 




Exponent allowed: 


No 


No 




Number of Values 
per Operand: 


Multiple 


Multiple 




Padding: 


With zeros at left 


With zeros at left 




Truncation of 
Assembled value: 


At left 


At left 
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CAOT ION ; Specification cf Y-type address constants with 
relocatable expressions should be avoided in programs that 
are to be executed en irachines having more than 32,767 
bytes of storage capacity. In any case, Y-type relocatable 
address constants should not be used in programs to be 
executed under IEM Systeir/370 ccntrcl. 

The A-type and Y-type address constants are processed 
as follows: If the ncirinal value is an absolute expression, 
it is computed to its 32-tit value and then truncated en 
the left to fit the implicit or explicit length of the 
constant. If the ncirinal value is a relocatable or complex 
relocatable expression, it is not completely evaluated 
until linkage edit time when the object modules are 
transformed into load modules. The 24-bit (or smaller) 
relocated address values are then placed in the fields 
set aside fcr them at assembly time by the A-type and Y- 
type constants. 



G3K — THE S-TYPE AttRESS CONSTANT 



Fur pose 

You can use the S-type address constant tc assemble an 

explicit address (that is, an address in hase-displacenert 

form) . You can specify the explicit address yourself or 

allow the assembler to compute it from an implicit address, 

using the current base register and address in its /<~~\ 

computation (for details en implicit and explicit addresses, \_p) 

see E5B) . 



Specifications 



The contents cf the sutfields defining the S-type address 
constants are described in the figure en tbe opposite page. 

The nominal values can be specified in twe ways: 



A 1. As one absolute or relocatable expression representing 
an implicit address 

^p2. As two absolute expressions, the first of which 

©represents the displacement an3 the second, the base ^^ 
register. ^P 



Xj) 
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Subfield 


Address Constants (S) 


3. Constant Type 


1. Duplication Factor 
Allowed 


§-Type 






Yes 






2. Modifiers 

Implicit Length: 
(Length Modifier not 
present) 


2 bytes 






Alignment: 
(Length Modifier not 
present) 


Half word 






Range for length: 
(in bytes) 


2 only (no bit length) 






Range for Scale: 


Not allowed 






Range for Exponent: 


Not allowed 






4. Nominal Value 
Represented by: 


Absolute or Itf^ 
relocatable expression J ^^ 

Two absolute \^^ 
expressions ]^9 


DC S(RELOC) 

DC S(1024)ft Q 

DC S(512(12)) 


E 

JE 


"fSo 




[Base cwrtent 


ic 


t®§ 








Enclosed by: 


Parentheses 






Exponent allowed: 


No 






Number of Values 
per operand : 


Multiple 






Padding: 


Not applicable 






Truncation of 
Assembled value: 


Not applicable 
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G3L — THE V-TYPE AEERESS CONSTANT 



/f~N 



Purpose 



The V-type address constant allows you to reserve storage 
for the address of a location in a control section that 
lies in another source module. You should use the V-type 
address constant only tc tranch to the external address 
specified. This use is contrasted with another method, 
that is: of specifying an external symbol, identified 
by an EXTRN instruction, in an A-type address constant 
(for a comparison, see E2) . 



Because you specify a symbol in 
a V-type address constant, the 
assembler assumes that it is an 
external symbol. A value of zero 
is assembled into the space reserved 
for the V-type constant; the corre ct 



relocated value of the address is 
inserted into this space by the 
linkage editor before your object 
program is loaded. 



Source 
Module 



Object Module 
in Hex 

A 



Load Module 
in Hex 



A START 



DC V (OUTSIDE) 



END 



►00000000 



00003000 



OUTSIDE 



X'3000' OUTSIDE 



k. 



Specifications 



The contents cf the sufcfields defining the V-type address 
constants are described in the figure on the opposite page. 



The symbol specified in the nominal value subfield dees 
not constitute a definition of the symbol for the source 
module in which the V-type address constant appears. 

The symbol specified in a V-type constant must net represent 
external data in an overlay program. 
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Subfield 


Address Constants (V) 




3. Constant Type 


1 . Duplication Factor 
allowed 


V-Type 






Yes 






2. Modifiers 

Implicit length: (Length 
Modifier not present) 


4 bytes 






Alignment: (Length 
Modifier not present) 


Full word 






Range for Length: .,. 
( in bytejss) 


4 or 3 only 
(no bit length) 






Range for Scale: 


Not allowed 






Range for Exponent: 


Not allowed 






4. Nominal Value 
Represented by: 


A single relocatable 
symbol 


DC V(MODA) 

© 

DC V(EXTADR) 




Enclosed by: 


Parentheses 






Exponent allowed: 


No 






Number of values 
per Operand: 


Multiple 






Padding: 


With zeros at left 






Truncation of 
assembled value: 


Not applicable 
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Page of GC33-4C10-1 
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OS G3K ~ THE O-TYPE 
only 

Eurpcse 

You use this constant tc reserve storage fcr the offset 
into a storage area of an external dummy section. The 
offset is entered intc this space fcy the linkage editcr. 
When the offset is added to the address of an overall fclcck 
of storage set aside fcr external duirroy sections, it allows 
you tc address the desired section. (JFor a descripticr. 
of the use of the Q-type address constant in combination 
with an external dummy section, see E4.) 

Specifications 






The contents cf the suhfields defining the Q-ty^e address 
constant are described in the figure below. 

(The symbol specified in the nominal value subfield roust 
be previously defined as the label of a EXE or ESECT 
statement. 



Subfield 



1. Duplication Factor 
allowed 



2. Modifiers 

Implicit Length: (Length 
Modifier not present) 



Alignment: (Length 
Modifier not present) 



Range for Length: 
(in bytes) 



Range for Scale: 



Range for Exponent: 



4. Nominal Value 
Represented by 



Enclosed by: 



Exponent allowed: 



Number of Values per 
Operand: 



Padding: 



Truncation of 
Assembled Value 



Address Constants (Q) 



3. Constant Type 



<£_ 



Q-Type 



Yes 



4 bytes 



Full word 



1-4 bytes 
frio bit length) 



Not allowed 



Not allowed 



A single relocatable 
symbol 



Parentheses 



No 



Multiple 



With zeros at left 



At left 



DC Q(DUMM YEXT)^ 
DC Q(DXDEXT) WW 



%) 
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G3K — THE ES INSTRUCTION 
Purpose 

The ES instruction allows you to: 

1. Reserve areas cf storage 

2. Provide labels for these areas _, 

3. Use these areas by referring to the symbols defined 
as labels. 

The ES instruction causes no data tc be assembled. Unlike 
the EC instruction (see G3E) , you do net have tc specify 
the nominal value (fcurth subfield) of a DS instruction 
operand. Therefore, the ES instruction is the best way 
of symbolically defining storage for work areas, 
input/output buffers, etc. 






How to Use the DS Instruction 



TO RESERVE STORAGE? If ycu wish 
to take advantage of automatic 
boundary alignment (if the ALIGN 
option is specif ied)/ and implicit 
length calculation, ycu should not 
supply a length modifier in your 
operand specifications. You should 
specify a type subfield that 
corresponds to the type of area 
you need for your instructions 
(See individual types in sections 
G3D through G3M) . 



Named (Mnemonic) 
Areas for Fixed- 
Point Instructions 


Areas Aligned on 
Boundary 

o 


Length Attribute of 
Symbols Naming Areas 
same as Implicit 
Length of Areas 


FAREA DS F 
HAREA DS H 
AAREA DS A 

DUPF DS 10F 


Full word 
Half word 
Full word 

c ull word 




^ 4 
2 
4 

L'DUPF=4 


10 full words of 
storage reserved 




duplication has no 
effect on implicit 
length 










Named Areas for 

Floating-Point 

Instructions 




\ 


EAREA DS 3E 
DE AREAS DS 90 


Full word 
Double word 

Double word 


4 
8 


9 double words 
reserved 


LAREA DS L 






16 
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O Using a length modifier can give 
you the advantage of explicitly 
A specifying the length attribute 
value assigned to the label naming 
the area reserved. However, your 
areas will not be aligned 
automatically, according to their 
A type, if vou omit the nominal value 
^^ in the operand, you should use a 
length modifier for the binary (E) , 
character (Q , hexadecimal (X) , 
and decimal (F and Z) type areas; 
-^ otherwise their labels will be given 
KB a length attribute value of 1. 



Area Specified 


Area 


Length 


O 


Reserved in 
in Bytes 


Attribute 



TEN DS CLIO" 


10 


if 


TW056 DS XL256 


256 


256 


F3 DS FL3 


3 


3 


D7 DS DL7 


7 


7 . 


A2 DS AL2 


2 


2 


o 






CI DS CL16 


16 


16 


C2 DS ^flc^A 
C3 DS fc ~^* 


16 
1 


/ 1 


o 




O 





>^200 


200 


XI 


DS -j XL20 


X2 
X3 


DS X A 

DS ZQ$W\, 


/ 1 
' 200 


1 

ji 


o 




Duplication factor 








has no effect on 










length attribute 






















\i^ 



c 
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When you need tc reserve large areas ycu can use a 
duplication factor. However, you can only refer tc the 
first area by the label in this case. Ycu can also use 
the character (C) and hexadecimal (X) field types tc specify 
large areas using the length ncdifier. 



c 



Area Specified 



© 



t 



LARGEF^DS 10FL3 



Area Reserved 
in Bytes 



Automatic 

Boundary 

Alignment 



30-^ NONI 



Length Attribute 
of symbol used 
as Label 



pL— i i i 

LARGED^DS 100D 1^-800-^ ..DOUBLE WORD 




I 



]-_- 




LARGEA^DS 60A I 240-.»^FULL WORD 

i a i i 



LARGEC DS 1000C 
C2 DS CLIO 00 



1000 
1000 



Duplication has 
no effect 



NONE 
NONE 



o 



Maximum of 
65,535 allowed 



XLARGE DS XL2006 



LARGERX DS 2XL2000 4000 



2000 



NONE 
NONE 



1 
1000 



2000 
2000 
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© 



Although the nominal value is 
optional for a DS instruction, you 
can put it to good use by letting 
the assembler compute the length 
for areas of the E, C, X, and decimal 
(P or Z) type areas. You achieve 
this by specifying the general 
format of the nominal value that 
will be placed in the area at 
execution time. 



Area Specified 





Area 
Reserved 
in bytes 



16 



Length Atribute 
or computed 
implicit length 
of area 
(duplication 
disregarded) 



16 



2 


2 


60 


2 


3 


3 


15 


3 


5 


5 



TO FORCE ALIGNMENT; Ycu can use 
the DS instruction to force alignment 
to a boundary that otherwise would 
not be provided. You do this by 
using a duplication factor of zero. 
No space is reserved for such an 
instruction, yet the data that 
follows is aligned on the desired 
boundary. 

NOTE: Alignment is forced when 
either the ALIGN or NOALIGN assembler 
option is set (see C2) . 



DS OD 
AREA DS CL128 



© 
e 



Double word 



AREA 



3C 







DS OF 
KEY DC C'A' 
ADCON DC AL3(SOMWHERE) 

o 

HERE. DS OH 

LH 3 , SUM 
AH 3, CONST 
STH 3, RESULT 




HERE addresses 
same location as 
following 
instruction (LH) 



Full word 



m 



xxxxx 



A Address of 
SOMWHERE 




y 
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TO NAME FIELDS OF AN AREA; Using a duplication factor 
of zero in a ES instruction also allows you to provide 
a label for an area c£ storage without actually reserving 
the area. You can use ES or EC instructions to reserve 
storage for and assign labels tc fields within the area. 
These fields can then be addressed symbolically. (Another 
way of accomplishing this is described in E3C.) The whole 
area is addressable by its label. In addition, the syirbclic 
label will have the length attribute value of the whole 
area. Within the area each field is addressable by its 
label. The EATE field has the same address as the subfield 
EAY. However, EATE addresses 6 bytes, while DAY addresses 
only 2 bytes. 






card columns 



Format of 80 
Character Record 



Symbol Length 
Attribute 



.80 



RECAREA 



6 


PAYNO 


DS 


CL6 


20 

o 


NAME 


DS 


CL20 


DATE 


DS 


0CL6 


2 


DAY 


DS 


CL2 


2 


MONTH / 


DS 


CL2 


2 


YEAR 


DS 


CL2 






DS 


CLIO 


8 


GROSS 


DS 


CL8 


8 


TAXES 


DS 


CL8 






DS 


CL18 




RECAREA'' 





*< 




DATE 








DAY 






MONTH 








YEAR 






2 bytes 




j 



80 

bytes 

long 
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Specifications 



The fcrrrat cf the ES instruction 
statement is given in the figure 
to the right. 

The format cf the operand of a DS 
instruction is identical to that 
of the CC operand (see G3B) . 















1 


Name 


Operation 


Operand 


Any Symbol 
or blank 


DS 


One or more 
Qp«nm| separated 










^M\ Operand Format | 

Duplication Type Modifiers J Zeroormorel 
Factor J Nominal Values! 



/ 



The two differences in the 
specification of subfields are: 

The nominal value subfield is 
optional in a ES operand , but it 
is mandatory in a DC operand. If 
a nominal value is specified in 
a ES operand, it must be valid. 

The maximum length that can be 
specified in a ES operand for the 
character (C) and hexadecimal (X) 
type areas is 65,535 bytes, rather 
than 256 bytes for the same EC 
operands. 



OPTION1 


DS 


3FL3 ^A 


OPTION2 


DS 


AMUST 


DC 


3FL3»H 


LONGC 


DS 


CL65535^ 
XL65535^ 


LONGX 


DS 


LIMITEDC 


DC 


CL256'A' 


LIMITEDX 


DC 


XL256'00' 



a 



v 
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The label used In the name entry of a ES instruction, like 
the label fcr a EC instruction (see G3E) : 

^fc 1- Has an address value of the leftmost byte of the area 
^^ reserved, after any boundary alignment is performed 

©2. Has a length attribute value , depending on the implicit 
or explicit length of the type of area reserved. 

If the ES instruction is specified with ircre than one 
operand or more than one nominal vajlue in the operand, 

Othe label addresses the area reserved for the field that 
corresponds to the first nominal value of the first operand. 
Olhe length attribute value is equal to the length explicitly 
specified or implicit in the first operand. 




None 
None 

None 



Boundary 


Symbol 


Alignment 


Length 




Attribute 


Only if 




Length 


Duplica- 


Modifier 


tion has 


is not 


no effect. 


specified 






© 


Byte 


1 


Halfword 


2 


Fullword 


4 


Double word 


8 


Fullword 


4 



3 

5 

7000 



OPRNDS DS 3F,3C 



VALUES DS A(P,Q,R) I 



MORE DS H'7,8,9' 



Full word 
None 

Full word 
Half word 



o 
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NOTE: Unlike the DC instruction, 
bytes skipped for alignment are 
not set to zero. Also, nothing 
' is assembled into the storage area 
reserved by a DS instruction. No 
assumption should be made as to 
the contents of the reserved area. 

The size of a storage area that 
can te reserved by a DS instruction 
is limited only by the size of 
virtual storage or by the maximum 
value of the location counter, 
whichever is smaller. 



SKIPPED! DS 3D 




Unknown 
Contents 



Double word Boundary 






XXX 



■ 8 bytes 



End of Last 
Data Entry 




v v 



\j 
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G30 — THE CCW INSTRUCTIOK 



Purpose 



You can use the CCW instruction to define and generate 
an eight-byte channel command word for input/output 
operations. 






The channel command word is an 
eight-byte field aligned at a 
doubleword boundary, and contains 
the information described in the 
figure to the right. 





















Byte 


/ 


Doubleword 
Boundary 












bits 
bits 





7 




1 
2-4 

5 

6 
7-8 


Command 
Code 






8 




31 






Address of data to operate upon 




bits 




32 37 38 39 


. 




bits 
bits 


Flags 


7 *N 






'■:■■.' 




Must be Specified 
as Zeros 








40 47 










\: • 


\ 






s. 


Set to Zeros 
by Assembler 










48 


63 






Byte Count or Length of Data 



















Specifications 



The format of the CCW instruction 
statement is given in the figure 
to the right. 











Name 


Operation 


Operand 


Any symbol 
or blank 


CCW 


Four operands separated 
by commas 
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OA11 fcur operands must be specified 
in the order described in the figure 
to the right. The generated channel 

©command word is aligned on a 
doubleword boundary. P.ny bytes 
skipped are set tc zerc. 

The symbol in the name field, if 

present, is assigned the value of 
A the address of the leftmost byte 
^^ of the channel command word 

generated. The length attribute 

value of the symbcl is 8. 



L'WRITE=8 



WRITE CCW l^ATADRjXMS 1 ,X'50* 



Values are 
right justified 
in fields 



Assembled 
into 




Object Code 
in hex 



/f~>\ 



n 




Must be Specified 
as Zeros 










Treated as 
as 3-byte 
A-Type 
address 
constant 




i 









^-_V 



J 
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Section H: Controlling the Assembler Program 



This section describes the assembler instructions that 
request the assembler to perform certain functions that 
it would otherwise perform in a standard predetermined 
way. You pan use these instructions to: 

1. Change the standard coding format for writing your 
source statements 

2. Control the final structure of your assembled program 

3. Alter the format of the source module and object code 
printed on the assembler listing 

4. Produce punched card output in addition to the object 
deck 

5. Substitute your own mnemonic operation codes for the 
standard codes of the assembler language 

6. Save and restore programming environments, such as the 
status of the PRINT options and the USING base register 
assignment. 






HI -- Structuring a Program 



The instructions described in this subsection affect the 
location counter and thereby the structure of a control 
section. You can use them to interrupt the normal flew 
of assembly and redefine portions of a control section 
or to reserve space to receive literal constants. Alsc, 
you can use them to align data on any desired boundary. 
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HI A — THE ORG INSTRUCTION 



Purpose 



e 
© 



o 



You use the ORG instruction to alter 
the setting of the location counter 
and thus control the structure of 
the current control section. This 
allows you to redefine portions 
of a control section. 

For example, if you wish to build 
a translate table (to convert EECEIC 
character code into scire other 
internal code) : 

1- You define the table as being 
filled with zeros. 

2. You use the ORG instruction to 
alter the location counter so that 
its counter value indicates a desired 
location within the table. 

3- You redefine %he data to be 
assembled into that location. 

4. After repeating the first three 
steps until your translate table 
is complete, you use an ORG 
instruction with a blank operand 
field to alter the location counter 
so that the counter value indicates 
the next available location in the 
current control section (after the 
end of the translate table) . 

Both the assembled object code for 
the whole table filled with zeros 
and the object code for the portions 
of the table you redefined are 
printed in the program listings. 
However, the data defined later 
is loaded over the previously defined 
zeros and becomes part of your 
object program, instead of the 
zeros. 

In other words, the ORG instruction 
can cause the location counter to 
point to any part of a control 
section, even the middle of an 
instruction, into which you can 
assemble desired data. It can also 
cause the location counter to point 
to the next available location so 
that your program can continue to 
be assembled in a sequential fashion. 





Source Module 




FIRST 
TABLE 


START 

DC 
ORG 
DC 
DC 




o 

XL256'00» 
TABLE +0 m 
CO' ft^* 
C'l' ^ 


Object Code 

TABLE 
(in Hex) 


+0 . 


F0 
Fl 






ORG 

• V 


TABLE+13 


+13 








DC 
DC 


CD' 
C»E' 




C4 
C5 




© 


• 












ORG 

DC 

DC 


TABLE+C ' D ' 

AL1(13) 

AL1(14) 


+196 


0D 
0E 




© 


ORG 

DC 

DC 

ORG 

DS 


TABLE+C ' ' 

AL1(0) 

AL1(1) 

OH 


+240 
+255 


00 
01 




JTABLE+25( 


I 

GOON 










TR 


INPUT , TABL 


E 


INPUT 


DS 
END 


CL20 





w 
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Specifications 

The format ,of the ORG instruction 
is shown in the figure to the right.' 









^^^^^^H 


Name 


Operation 


Operand 


OS 

Any symbol 

or blank 


ORG 


A relocatable 
expression 
or blank 



£"\ 



The symbols in the expression in 
the operand field must be previously 
defined. The unpaired relocatable 
term of the expression (see C6E) 
must be defined in the same control 
section in which the ORG statement 
appears. 

The location counter is set to the 
value of the expression in the 
operand. If the operand is omitted, 
the location counter is set to the 
next available location for the 
current control section. 



in Hex 

0C08 
OCOC 



0D80 



Source Module 



Location 



SECTA 



HERE 



START 



L 
MVC 



ORG 



3,ADDR 
TO, FROM 



HERE+4 




0D80 



0D80 



This portion will 
be loaded starting 
address X'COC 



"^^S^Sj 




Spill 



ORG 

L 4 ,AREA 

A 4, TWO 

ST 4 , SUM 



END 



The expression in the operand of 
an ORG instruction must not specify 
a location before the beginning 
of the control section in which 
' it appears. In the example to the 
) right, the ORG instruction is invalid 
if it appears between the beginning 
of the current control section and 
500 bytes from the beginning of 
the same control section. This 
is because the expression specified 
is then negative and will set the 
location counter to a value larger 
than the assembler can process. 
The location counter will "wrap 
around" (the location counter is 
discussed in detail in section CUB) . 








Source Module 








e 


Negative 


FIRST 


START 
A ORG 
END 


*-500 


: 






* 
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NOTE: Using the ORG instruction 
to insert data assembled later at 
the same location as earlier data 
will not always work. 

In the example to the right, it 
appears as if the character constant 
will be loaded over the address 
constant . However, after the 
character constant is loaded into 
the same location as the address 
constant, the relocation factor 
required for the address constant 
is added to the value of the 
constant. This sum then constitutes 
the object code that resides in 
the four bytes with the address 
ADDR. 



H1B — THE LTORG INSTRUCTION 



ADDR 

CHAR 

Assembled 

ADDR 



|X X X X| 

(ADDR) 
BETA 
IC2C5E3C1] 



DC 

ORG 

DC 
Processing Sequence 

» 

Loaded 

ADDR £k 



I I 



[C2C5E3C1 | 



e 

A(LOC) 
*-4 
C'BETA' A 

Relocation facjor 
added to value 
of constant CHAR 

ADDR 



/ f > \ 



s/ 



Purpose 



You use the LTORG statement so that 
the assembler can collect and 
assemble literals into a literal 
pool. A literal peel contains the 
literals you specify in a source 
module either: 

After the preceding LTORG instruction 
or 

After the beginning of the source 
module. 

The assembler ignores the borders 
between control sections when it 
collects literals into pools. 
Therefore, you must be careful to 
include the literal pools in the 
control sections to which they 
belong (for details see Addressing 
Considerations belcw) . 

The creation of a literal pool gives 
the following advantages: 

1. Automatic organization of the 
literal data into sections that 
are properly aligned and arranged 
so that no space is wasted 

2. Assembling. of duplicate data 
into the same area 

3. Because all literals are cross- 
referenced, you can find the literal 
constant in the pool into which 

it has been assembled. 



Source Module 



START 




LTORG 




214 






O 



e 



The Literal Pool 



A literal pool is created immediately 
after a LTORG instruction or, if 
no LTCRG instruction is specified, 
at the end of the first control 
section. 

Each literal pool has four segments j 
into which the literals are stored 
(1) in the order that the literals 
are specified and (2) according 
to their assembled lengths, which, 
for each literal, is the total 
explicit or implicit length, as 
described below. 

The first segment contains all 
literal constants whose assembled 
lengths are a multiple of eight. 

The second segment contains those 
whose assembled lengths are a 
multiple of four, but not of eight. 

The third segment contains those 
whose assembled lengths are even, 
but not a multiple of four. 

The fourth segment contains all 
the remaining literal constants 
whose assembled lengths are odd. 

The beginning of each literal pool 
is aligned on a doubleword boundary . 
Therefore, the literals in the first 
segment are always aligned on a 
doubleword boundary, those in the 
second segment on a fullword 
boundary , and those i-ri the third 
segment on a half word boundary . 



Source Module 



FIRST 



START 
MVC 



10,=1Y % $ % 



Literal Pool 
Start 




Assembled into 
Segment 

© 

o 

o 
o 
o 
e 

o 



END x 
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Addressing Considerations 



If you specify literals in source 
modules with multiple control 
sections, you .should: 

1. Write a LTORG instruction at 
the end of each control section, 
so that all the literals specified 
in the section are assembled into 
the one literal pool for that 
section. If a control section is 
divided and interspersed among other 
control sections, ycu should write 

a LTCBG instruction at the end of 
each segment of the interspersed 
control section. 

2. When establishing the 
addressability of each control 
section, make sure (a) that the 
entire literal pool for that section 
is also addressable, by including 

it within a USING range , and (b) 
that the literal specifications 
are within the corresponding USING 
domain. The USING range and domain 
are described in F1A. 

NOTE: All the literals specified 
after the last LTORG instruction, 
or, if no LTORG instruction is 
specified, all the literals in a 
source module are assembled into 
a literal pool at the end of the 
first control section. You must 
then make this literal pool 
addressable along with the addresses 
in the first control section. This 
literal pool is printed in the 
program listing after the END 
instruction. 



Source Module 



USING 

range 
ONE 



USING 

range 

TWO 



ONE START 

USING 0NE,BASREG1 



i i 



© 



USING 
domain ONE 



LTORG 



Literal Pool 11 



'TWO CSECT 
USING 



LTORG 



Literal Pool % 



END 




,.<f~>\ 



V. 



o 
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Euplicate Literals 



If you specify duplicate literals 
within the part of the source module 
! that is controlled by a LTORG 
instruction, only one literal 
constant is assembled into the 
pertinent literal peel. This also 
applies to literals assembled into 
the literal pool at the end of the 
first or only control section of 
a source module that contains no 
LTORG instructions. 

j Literals are duplicates only if 
their specifications are identical, 
not if the object code assembled 
happens to be identical . 

When two literals specifying 
. identical A-type (or Y-type) address 
' constants contain a reference to 
the value of the location counter 
(*) , both literals are assembled 
into the literal pool. This is 
because the value cf the location 
counter is different in the two 
literals. 



Source Module 



BEGIN START 




LTORG 



Literal pool 1 



SECOND CSECT 




> LTORG 



Literal pool 2 



END 



Action 



both are stored 



first is stored 



both are stored, each 
into a separate literal 
pool 



both are stored 



both are stored 



Specifications 



The format of the LTORG instruction 
is given in the figure to the right. 

If an ordinary symbol is specified 
in the name field, it represents 
the first byte of the literal pool; 
this symbol is aligned on a 
doubleword boundary and has a length 
attribute value of one. If bytes 
are skipped after the end of a 
literal pool to achieve alignment 
for the next instruction, constant, 
or area, the bytes are not filled 
with zeros. 







LTORG 


Name 


Operation 


Operand 


Any symbol 
or blank 


LTORG 


Not required 
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H1C — THE CNOP INSTRUCTION 



Purpose 



You can use the CNOP instruction 
to align any instruction or other 
data on a specific halfword boundary . 
The CNOP instruction ensures an 
unbroken flow of executable 
instructions by generating no- 
operation instructions to fill the 
bytes skipped to perform the 
alignment that you specified. 

For example, when ycu cede the 
linkage to a subroutine, you may 
wish to pass parameters to the 
subroutine in fields immediately 
following the branch and link 
instruction. These parameters, 
for instance, channel command words 
(see G30) , can require alignment 
on a specific boundary. 

The subroutine can then address 
the parameters you pass through 
the register with the return address. 



O 



O 



Assume location 
counter is at 
doubleword 
boundary 



Register Contents 

Return address 
(LINK -H 2) 
Address of sub- 
routine 



CNOP 6 , 8 



LINK BALR 2,10 



X Equivalent \X 




ccw 


ONE | 






ccw 


TWO | 






ccw 


THREE 


. . 





Layout of 
Object Code 



double half full \ half double 
word word word, word W ord 




Specifications 



The CNOP instruction forces the 
alignment of the location counter 
to a halfword, fullword, or 
doubleword boundary. It does not 
affect the location counter if the 
counter is already properly aligned. 
If the specified alignment requires 
the location counter tc be 
incremented, one to three no- 
operation instructions (BCR 0,0 
occupying two bytes each) are 
generated to fill the skipped bytes. 
Any single byte skipped to achieve 
alignment to the first no-operation 
instruction is filled with zeros. 
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The format of the CNOP instruction 
statement is given in the figure 
to the right. 

The operands must be absolute 
expressions, and any symbols must 
have been previously defined. 
The first operand , b, specifies 
at which even-numbered byte in a 
fullword or doubleword the location 
counter is set. The second operand ? 
w , specifies whether the byte is 
in a fullword (w=4) or a doubleword 
(w=8) . Valid pairs of b and w are 
as indicated in the figure to the 
right. 

NOTE: Both 0,4 and 2,4 specify 
two locations in a doubleword. 



OS 



Name 



Any symbol 
or blank 

Sequence symbol 
orbtaik 



Operation 



CNOP 



CNOP 



Operand 



b,w 

oe 



0,4 


2,4 
FULLWORD 


0,4 


2,4 

* 
FULLWORD 




HALFWORD 


HALFWORD 


HALFWORD 


HALFWORD 


Byte 


Byte 


Byte 


Byte 


Byte 


Byte 


Byte 


Byte 


I 


J 




DOUBLEWORD 

4,8 6 8 





H2 - Determining Statement Format and Sequence 






You can change the standard coding conventions for the 
assembler language statements or check the sequence of 
source statements by using the following instructions. 



H2A — THE ICTL INSTRUCTION 



Purpose 



The ICTL instruction allows you to change the begin, end, 
and continue columns that establish the coding format cf 
the assembler language source statements. 

For example, with the ICTL instruction, you can increase 
the number of columns to be used for the identification 
or sequence checking of your source statements. By changing 
the begin column, you can even create a field before the 
begin column to contain identification or sequence numbers. 
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You can use the ICTL instruction 
only once, at the very beginning 
of a source module. If you do not 
use it, the assembler recognizes 
the standard values for the, begin, 
end, and continue columns. 



Standard values for Columns 



BEGIN 



CONTINUE 



END 



It 



1 
Columns 



16 



3C 



w 



Standard 
identification 
sequence field 



/f\ 



© 



Specifications 



The ICTL instruction, if specified, 
must be the first statement in a 
source module. 

The format of the ICTL instruction 
statement is shown in the figure 
to the right. 

The operand entry must be one to 
three decimal self -defining terms. 
There are only three possible ways 
of specifying the operand entry. 

The operand b must always be 
specified. The operand e . when not 
specified, is assumed to be 71. 
If the operand c is not specified, 
or if e is specified as 80, the 
assembler assumes that continuation 
lines are not allowed. The values 
specified for the three operands 
depend on each other . 



NOTE: The ICTL instruction does 
not affect the format of statements 
brought in fcy a COPY instruction 
or generated from a library macro 
definition. The assembler processes 
these statements according to the 
standard begin, end, and continue 
columns described in Section B1A. 





■/ 




■H 


Format 




Name 


Operation 


Operand 


Blank 


ICTL 


b or 
b,e or 
b,e,c 


o 






Operands 






Specifies 


Allowable range 


© 
© 

o 


Begin column 
End column 
Continue column 


1 through 40 
41 through 80 

2 through 40 




^P Rules for interaction of b, e and c 


The position of the End column must 
not be less than the position of the Begin 
column + 5, but must be greater than the 
position of the Continue column 


e >b + 5 
e >c 


The position of the Continue column 
must be greater than that of the Begin 
column 


Ob 





V 



Jr 
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H2B — THE ISEQ INSTRUCTION 



Purpose 



You can use the ISEQ instruction 
to cause the assembler to check 
if the statements in a source module 
are in sequential order. In the 
ISEQ instruction you specify the 
columns between which the assembler 
is to check for sequence numbers. 

The assembler begins sequence 
checking with the first statement 
line following the ISEQ instruction. 
The assembler also checks 
continuation lines . > 

Sequence numbers on adjacent 
statements or lines are compared 
according to the 8-bit internal 
EBCDIC collating sequence. When 
the sequence number on one line 
is not greater than the sequence 
number on the preceding line, a 
sequence error is flagged, and a 
warning message is issued, but the 
assembly is not terminated. 

NOTE: If the sequence field in the 
preceding line is blank, the 
assembler uses the last preceding 
line with a non-blank sequence field 
to make its comparison. 



Specifications 



The ISEQ instruction initiates or 
terminates the checking of the 
sequence of statements in a source 
module. 

The format of the ISEQ instruction 
is shown in the figure to the right. 

i The first option in the operand 
entry must be two decimal self- 
defining terms. This format of 
the ISEQ instruction initiates 
sequence checking, beginning at 
the statement or line following 

I the ISEQ instruction. Checking 
begins at the column represented 
by 1 and ends at the column 
represented by r . The second 

! option of the ISEQ format terminates 
the sequence checking operation. 



ISEQ 73,80 



73 80 Compares made 

o 




ONE 



TWO 



THREE 



FOUR 



CONTINUA) JTION CARD 



FIVE 



ONE with TWO 

TWO with THREE 
THREE with FOUR 
FOUR with FIVE 

and so on 




Name 


Operation 


Operand 


Blank 


ISEQ 


or blank KB j 



Column 


Specifies 


Rules for interaction 






leftmost column of 
field to be checked 




I2r 1 must not be 
greater than r 

r > 1 r must not be 
less than 1 




1 and r not allowed 
to lie between begin 
and end columns 




rightmost column 
of field to be checke 


d 
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NOTE: The assembler checks only 
those statements that are specified 
in the coding of a source module. 
This includes any COPY instruction 
statement or macro instruction. 

However, the "assembler does not 
check: 

1. Statements inserted by a COPY 
instruction 

2. Statements generated from model 
statements inside macro definitions 
or from model statements in open 
code (statement generation is 
discussed in detail in Section J) 

3. Statements in library macro 
definitions. 



H3 -- Listing Format and Output 





Source Module 






FIRST START 

ISEQ 73,80 

T 

checking 
occurs 

1 

ISEQ 

T 
checking 
does not 
occur 

♦ 

ISEQ 73,80 

checking 
resumed 

END f 


- 



'4^ 
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The instructions described in this 
section request the assembler to 
produce listings and identify output 
cards in the object deck according 
to your special needs. They allow 
you to determine printing and page 
formatting options other than the 
ones the assembler program assumes 
by default. Among ether things, 
you can introduce your own page 
headings, control line spacing, 
and suppress unwanted detail. 



H3A — THE PRINT INSTRUCTION 



Purpose 



The PRINT instruction allows you 
to control the amount of detail 
you wish printed in the listing 
of your programs. The three options 
that you can set are given in the 
figure to the right. 

They are listed in hierarchic order; 
if OFF is specified, GEN and DATA 
will not apply. If NOGEN is 
specified, EATA will not apply to 
constants that are generated. The 
standard options inherent in the 
assembler program are CN, GEN, and 
NO DATA. 



Hierarchy 


Description 


PRINT options 


1 


A listina is printed 


ON 
OFF 


No listina is Drinted 


2 


All statements generated by the 
processing of a macro instruction 
are printed 


GEN 
NOGEN 


Statements generated by the 
processing of a macro instruction 
are not printed (Note: The 
MNOTE instruction always causes 
a message to be printed) 


3 


Constants are printed in full in 
the listing 


DATA 
NODATA 


Onlv the leftmost eiaht bvtes of 
constants are printed in the 
listing 
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Specifications 



The format of the PRINT instruction 
statement is shown in the figure 
to the right. 

^P At least one of the operands must 
be specified, and at most one of 
the options from each group. The 
PRINT instruction can be specified 
any number of times in a source 
module, but only those print options 
actually specified in the instruction 
change the current print status. 

PRINT options can be generated by 
macro processing, at pre-assemtly 
time. However, at assembly time, 
all options are in force until the 
assembler encounters a new and 
opposite option in a PRINT 
instruction. 

OS The POSH and POP instructions, 
only described in H6, also influence 
the PRINT options by saving and 
restoring the PRINT status. 

NOTE: The option specified in a 
PRINT instruction takes effect after 
the PRINT instruction. If PRINT 
OFF is specified, the PRINT 
instruction itself is printed, but 
not the statements that follow it. 
If the NOLIST assembler option is 
specified in the job control 
language, the entire listing for 
the assembly is suppressed. 









PRINT 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


PRINT 


[ON 1 [ GEN 1 [ NODATAl 
LOFFJ L, NOGENJ L, DATA I , 


Any sequence of 
specification allowed 
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H3B ~ THE TITLE INSTRUCTION 



Purpose 



The TITLE instruction allows you 
to: 

^P 1. Provide headings for each page 
of the assembly listing of your 
source modules. 

2. Identify the assembly output 
cards of your object modules. You 

©can specify up to 8 identification 
characters that the assembler will 
^^ punch into all the output cards, 
^P beginning at column 73. 

DOS Dp to 4 identification characters 

are allowed. ™*w - N ..,;\ ; 

OThe assembler punches sequence 
numbers into the columns that are 
left, up to column 80. 

NOTE: The name field of the TITLE 
instruction is generated throughout 
the assembly listing, preceding the 
generation of the operand data from 
any TITLE instruction. 



TITLE 'THIS IS A HEADING 



Program Listing 





THIS IS A HEADING 



PROG TITLE 'heading' 

e 




r 



PROG 0003 



PROG 0002 
73 80 



, Object Deck 



o 



Specifications 



The format of the TITLE instruction 
statement is given in the figure 
to the right. 

Any of the five options can be 
specified in the name field. 

The first three options for the 
name field have a special 
significance only for the first 
TITLE instruction in which they 
are specified. For subsequent TITLE 
instructions, the first three options 
do not apply. 



TITLE 



Name 


Operation 


Operand 


option 








V 


A string of alpha- 


TITLE 


A character 


O 


meric characters 




string up to 


A variable symbol 




100 charac- 


b 


A combination of 




ters, en- 




land 2 




closed in 


4 


A sequence symbol 




apostrophes 


5 


blank 







\J 
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For the first TITLE instruction 
of a source module that has a non- 
blank name entry that is not a 
sequence symbol, the following 
applies: 

^p up to eight alphameric characters 
can be specified in any combination 
in the name field. 

AMS*^'*** £<*** alphameric characters 



These characters are punched as 
identification, beginning at column 
73, into all the output cards from 
the assembly, except those produced 
by the PUNCH and FEFFO instructions. 
The assembler substitutes the current 
value into a variable symbol and 
uses the generated result as 
identification characters. 

If a valid ordinary symbol is 
specified, its appearance in the 
name field does not constitute a 
definition of that symbol for the 
source module. It can therefore 
be used in the name field of any 
other statement in the same source 
module. 



e 



Q JID33 


\ TITLE 






















Object 
Deck 




[(Col. 73 76 




Examples of TITLE instructions 
in separate source modules: 


Source Statement 


Value of 
variable symbol 


Punched into cards 
beginning at col. 73 


&ID-^k TITLE 


MOD99A 


MOD99A 


pgm&k/ title 


200 


PGM200 


1234 TITLE 




1234 


SYMBOL TITLE 

e 




SYMBOL 
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The character string in the operand 
field is printed as a heading at 
the top of each page of the assembly 
listing. The heading is printed 
beginning on the page in the listing 
following the. page on which the 
TITLE instruction is specified. 
A new heading is printed when a 
subsequent TITLE instruction appears 
in the source module. 

Each TITLE statement causes the 
listing to be advanced to a new page 
(before the heading is printed) 
except when PRINT NOGEN is in use. 

Any printable character specified 
will appear in the heading, including 
blanks. Variable symbols are allowed. 
However, the following rules apply 
to ampersands and apostrophes: 

• A single ampersand initiates 
an attempt to identify a variable 
symbol and to substitute its current 
value . 

• Double ampersands or apostrophes 
specified, print as single ampersands 
or apostrophes in the heading. 

• A single apostrophe followed 
by one or more blanks simply 
terminates the heading prematurely. 
If a non- blank character follows 

a single apostrophe, the assembler 
issues an error message and prints 
no heading. 

Only the characters printed in the 
heading count toward the maximum 
of 100 characters allowed. 

NOTE: The TITLE statement itself 
is not printed in an assembly 
listing. 



TITLE 'HEADING ONE' 


\ 


r^-X- 




\ HEADING ONE 




- 






7 


Examples of head 


ings: 




Source Statement 

_^v 


Value 
of 

Variable 
Symbol 


Printed Heading 


TITLE 'HEADING &N 1 


TWO 


HEADING TWO 


TITLE 'HEADING && &\ ' 




HEADING & ' 


TITLE 'HEADING FOUR '/FIVE' 

o 




HEADING FOUR 


TITLE 'HEADING FOUR 'REMARKS 






**ERR0R** 







w 



Q 
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H3C — THE EJECT INSTRUCTION 



Purpose 



The EJECT instruction allows you 
to stop the printing of the assembly 
listing on the current page and 
continue the printing en the next ' 
page. 



e 



C 



Specifications 



The format of the EJECT instruction 
statement is shown in the figure 
to the right. 

The EJECT instruction causes the 
next line of the assembly listing 
to be printed at the top of a new 
page. If the line before the EJECT 
instruction appears at the bottom 
of a page, the EJECT instruction 
has no effect . An EJECT instruction 
immediately following another EJECT 
instruction causes a blank page 
in the listing. 

NOTE: The EJECT instruction 
statement itself is not printed 
in the listing. 



EJECT 



Name 



A sequence 
symbol or 
blank 



Operation 



EJECT 



Operand 



Not required 



Page 
Boundary 



Source Module 

Previous statement - 



Listing 



EJECT 



# 




Source Text 



Source Text 



Page 
Boundary 



Page 
Boundary 
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H3D — THE SPACE INSTRUCTION 



KJ 



Purpose 



You can use the SPACE instruction 
to insert one or more blank lines 
in the listing of a source module. 
This allows you to separate sections 
of code on the listing page. 



Specifications 



The format of the SPACE instruction 
statement is given in the figure 
to the right. 

The operand entry specifies the 
number of lines to be left blank. 
A blank operand entry causes one 
blank line to be inserted. If the 
operand specified has a value greater 
than the number of lines remaining 
on the listing page, the instruction 
will have the same effect as an 
EJECT statement. 

NOTE: The SPACE instruction itself 
is not listed. 









SPACE 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


SPACE 


A decimal 
self-defining term 
or blank 



V. 



-^ 



H4 - Punching Output Cards 

The instructions described in this section produce punched 
cards as output from the assembly in addition to those 
produced for the object module (object deck) . 



HUA — THE PUNCH INSTRUCTION 



Purpose 



The PUNCH instruction allows you to punch source or other 
statements into a single card. With this feature you can: 

1. Code PUNCH statements in a source module to produce 
control statements for the linkage editor. The linkage 
editor uses these control statements to process the object 
module. 

2. Code PUNCH* statements in macro definitions to produce, 
for example, source statements in other computer languages 
or for other processing phases. 

The card that is punched has a physical position immediately 
after the PUNCH instruction and before any other TXT cards 
of the object decks that are to follow. 
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Specifications 



The PUNCH instruction causes the 
data in its operand to be punched 
into a card. One PUNCH instruction 
produces one punched card, but as 
many PUNCH instructions as necessary 
can be used. 

The PUNCH instruction statement ./ 
can appear anywhere in a source 
module except before and between 
source macro definitions. If a 
PUNCH instruction occurs before 
the first control section , the 
. resultant card punched will precede 
'all other cards in the object deck. 

|The cards punched as a result of 
a PUNCH instruction are not a logical 
part of the object deck, even though 
they can be physically interspersed 
in the object deck. 



Source Module 

3E 



MACRO 
MACDEF1 

MEND 



MACRO 
MACDEF2 

MEND 



PUNCH 



FIRST START 



PUNCH 



'datal 



Object Module 
(Card Deck) 



PUNCH 'data 3' 




data2 



END 



c 



The format of the PUNCH instruction 
statement is shown in the figure 
to the right. 

All 256 punch combinations of the 
IBM System/370 character set are 
allowed in the character string 
of the operand field. Variable 
symbols are also allowed. 









PUNCH 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


PUNCH 


A character string of 
up to 80 characters, 
enclosed in apostrophes 
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jThe position of each character 
specified in the PUNCH statement 
[corresponds to a column in the card 



e 



© 



to be punched. However, the 
following rules apply to ampersands 
and apostrophes: 

1. A single ampersand initiates 
an attempt to identify a variable 
symbol and to substitute its current 
value. 

\2. Double ampersands or apostrophes 
'are punched as single ampersands 
or apostrophes. 

3. A single apostrophe followed 
by one or more blanks simply 
terminates the string cf characters 
punched. If a non-blank character 
follows a single apostrophe, an 
error message is issued and nothing 
is punched. 

Only the characters punched, 
including blanks, count toward the 
maximum of 80 allowed. 

NOTES : 

1. No sequence number cr 
identification is punched into the 
card produced. 

2. If the NCCECK option is specified 
in the EXEC statement of the job 
control language for the assembler 
program, no cards are punched: 
neither for the PUNCH or REPRO 
instructions, nor for the object 
deck of the assembly. 



PUNCH '%*I6 WILL START IK COL V 




o 

Position 12 3 4 5 6 7 



PUNCH ' 



13 15 



21 



This position 




^ 






Examples: 



Source 
Statement 



PUNCH 'CHARS &VAR' 



PUNCH 'CHARS && "' 



PUNCH 'CHARS A'>B 



/ 

e 



PUNCH 'CHARS A 'REMARKS 
* * * ERROR * * * 



PUNCH 'CHARS A' REMARKS 



Value of 
Variable 
Symbol 



ABC 



Characters 
Punched 



CHARS ABC 



CHARS &' 



CHARS A 



CHARS A 
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HUB — THE REPRO INSTRUCTION 



Purpose 



The REPRO instruction causes the 
data specified in the statement 
that follows to be punched into 
a card. Unlike the PUNCH 
instruction, the REPRO instruction 
does not allow values to be 
substituted into variable symbols 
before the card is punched. 



c 



Specifications 



The REPRO instruction causes data 
on the statement line that follows 
it to be punched into the 
corresponding columns of a card. 
One REPRO instruction produces one 
punched card. 

The REPRO instruction can appear 
anywhere in a source module except 
before and between source macro ^^ 
definitions . The punched cards ^p 
are not part of the object deck, 
even though they can be physically 
interspersed in the object deck. 



Source Module 



Repro appears before 
start of first control 
section; punched card 
will precede object 
deck 




OBJECT 
DECK 



The format of the REPRO instruction 
statement is shown in the figure 
to the right. 

The line to be reproduced can contain 
any of the 256 punch characters, 
including blanks, ampersands, and 
apostrophes. No substitution is 
performed for variable symbols. 







REPRO 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


REPRO 


Not required 



NOTES: 

1. No sequence numbers or identification is punched in 
the card. 

2. If the NODECK option is specified in the job control 
language for the assembles: program, no cards are punched: 
neither for the PUNCH or REPRO instructions, nor for the 
object deck of the assembly. 
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H5A — THE OPSYN INSTRUCTION 



Purpose 



The OPSYN instruction allows you 
to define your own set of symbols 
to represent operation codes for: 

1. Machine and extended mnemonic 
branch instructions. 

2. Assembler instructions including 
conditional assembly instructions. 

You can also prevent the assembler 
from recognizing a symbol that 
represents a current operation code. 



Specifications 



The OPSYN instruction must be written 
after the ICTL instruction and can 
be preceded only by the LJECT, ISEQ, 
PRINT, SPACE, and TITLE instructions. 
The CFSYN instruction must precede 
any source macro definitions that 
may be specified. 

The OPSYN instruction has two basic 
formats as shown in the figure to 
the right. 

-^ The operation code specified in ^^ 
^P the name field or the operand field ^p 
must represent either: 

1. The operation code of cne of 

the machine or assembler instructions 
as described in PARTS II, III, and 
PART IV of this manual, or 

2. The operation code defined by 
a previous CFSYN instruction. 

OThe OPSYN instruction assigns the 
properties of the operation code 
specified in the operand field to 
-^ the symbol in the name field. A 
^P blank in the operand field causes 
the operation code in the name field 
to lose its properties as an 
operation code. 



OPSYN 



Name 



Any 

symbol or 
| operation 
code 



An 

operation 

code 



Operation 



OPSYN 



OPSYN 



Operand 



An operation 
code M^ 



blank 




NEW 



MVC 



OPSYN 



OPSYN 



MVC 



No longer recognized 
by the assembler as 
a valid operation code 
in current source module 



Vv 
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R^S^ 



NOTE; The symbol in the name field 
can represent a valid operation 
code. It loses its current 
properties as if it had been defined 
in an OPSYN instruction with a blank 
operand field. Further, when the 
same symbol appears in the name 
field of two OPSYN instructions 
the latest definition takes 
precedence. 







Both now possess the 
properties of the LR 
machine instruction 
operation code 




OPSYN 



, , OPSYN 



ST 



STH 



Now represents 
STH machine 
operation 
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H0: - Saving and Restoring Programming Environments 
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The instructions described in this subsection can save 
and restore the status cf PRINT options and the base 
register assignment of your program. 



H6A — THE PUSH INSTRUCTION 



Purpose 

The PUSH instruction allows you to save the current PRINT 
or USING status in "push-down" storage on a last- in, first 
out basis. You can restore this PRINT and USING status 
later, also on a last-in, first-out basis, by using a 
corresponding POP instruction. 

Specifications 

The format of the PUSH instruction 
statement is shown in the figure 
to the right. 

One of the four options for the 
operand entry must be specified. 
The PUSH instruction does not change 
the status of the current PRINT 
or USING instructions; the status 
is only saved. 

NOTE: When the PUSH instruction 
is used in coirbination with the 
POP instruction, a maximum of four 
nests of PUSH PRINT - POP PRINT 
or PUSH USING - POP USING are 
allowed. 









PUSH 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


vT>USH 


Options 

PRINT 1 
USING 2 
PRINT, USING 3 
USING, PRINT 4 



\y 



H6B — THE POP INSTRUCTION 



Purpose 

The POP instruction allows you to restore the PRINT or 
USING status saved by the most recent PUSH instruction 



Specifications 

The format of the POP instruction 
is given in the figure to the right. 

One of the four options for the 
operand entry must be specified. 
The POP instruction causes the 
status of the current PRINT or USING 
instruction to be overridden by 
the PRINT or USING status saved 
by the last PUSH instruction. 

NOTE: When the POP instruction 
is used in combination with the 
PUSH instruction, a maximum of four 
nests Of PUSH PRINT - POP PRINT 
or PUSH USING - POP USING are 
allowed. 



instruction 






^^^^^^H 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


POP 


Options 

PRINT 1 

USING 2 

; PRINT, USING 3 

USING, PRINT 4 



i 
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In the opposite example, you can ^^ 
see how the USING environment is ^p 
saved and restored by a combination 
of PUSH and POP instructions. 

NOTE: The PUSH instruction does 
not change the current USING status; 
I you must do this yourself. 



■tf^ 



Source Module 



MACRO 



NEW 




PUSH 


USING 


USING 


BASENEW,12 


POP 


USING 



MEND 



FIRST START 
USING 



BASE ,12 



NEW 




Storage Stack 
for saved 
USING status 



empty 




PUSH USING 
I USING BASENEW / 12 



POP 



USING 



BASE ,12 
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fj) SECTION K: THE MACRO INSTRUCTION 

SECTION L: THE CONDITIONAL ASSEMBLY LANGUAGE 
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Section I: Introducing Macros 



This section introduces the basic macro concept; what you 
can use the macro facility for, how you can prepare ycur 
own macro definitions, and how you call these macro 
definitions for processing by the assembler. 

Read this section straight through before referring to 

the detailed descriptions identified by the cross- reference 

arrows . 

NOTE: IBM supplies macro definitions in system libraries 
for input/output and other control program services, such 
as the dynamic allocation of main storage areas. To process 
these macro definitions ycu only have to write the macro 
instruction that calls the definition. 



'{f*^ 

^o^ 
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Using Macros 



FOR TEXT INSERTION ; The main use of macros is to insert 
assembler language statements into a source program. 








































Coding 
time 




Pre-assembly 
or macro pro- 
cessing time 






Assembly 
time 














Source Module 


Macro Definition 


Source Module 




BEFORE 


AFTER 










Name=TEXTIN 
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You call a named sequence of statements (the macro 
definition) by using a macro instruction, or macro call . 
The assembler replaces the macro call by the statements 
from the macro definition and inserts them into the source 
module at the point of call . The process of inserting 
the text of the macro definition is called macro generation 
or macro expansion. The assembler expands a macro at pre- 
assembly time.* 

The expanded stream of code then becomes the input for 
processing at assembly time, that is, the time at which 
the assembler translates the machine instructions intc 
object code. 
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FOR TEXT MODIFICATION: You may want to modify the 
statements in a macro definition before they are generated. 

You can do this by supplying character string values as 
operands in a macro call. These values replace parameters 
in the statement to be generated. This means that you 
can change the content of the generated statements each 
time you call the macro definition. 









Source Module 



Macro Definition 




Name = MODIFY 
s $£\ Parameters: X,Y,Z 



Generated Result 
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FOR TEXT MANIPULATION ; You can also select and reorder 
the statements to be generated from a macro definition 
by using the conditional assembly language described later 
in this section. 



Source 
Module 



Macro 
Definition 




Name = SELECT 
Parameter: X 

If X=0, then generate 
first sequence; 
If X=1, then generate 
second sequence 



A 
B 
CI 



Generated 
Result 




^P The conditional assembly language allows you to manipulate 
text generation, for example, by branching upon the result 

Oof a condition test. You can choose exactly which 
statements will or will not be generated by varying the 
values you specify in the macro call. 



See SECTION L 
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The Basic Macro Concept 



To use the complete macro facility provided by the assembler 
you must: 

• Prepare a macro definition and 

• Call this definition using a macro instruction. 






Prototype 



These statements 
establish limits of 
a macro definition 



Body of a 

macro 

definition 




MACNAME 




Sequence of 
Statements 



e 




Macro Instruction 



HE 



MACNAME 



You can create a macro definition by enclosing any sequence 
of assembler language statements between the MACRO and 
MEND statements, and by writing a prototype statement in 
which you give your definition a name. This name is then 
the operation code that you must use in the macro 
instruction to call the definition. 



I SeeJ2C~^> 
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When you write a macro instruction in your source irodule, 
you tell the assembler to process a particular macro 
definition . The assembler produces assembler language 
statements from this macro definition for each macro 
instruction that calls the definition. 



O 

e 



See SECTION K 



See SECTION J 



> 
> 
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Source Module 



■■■■■IH 

kMacro Instruction 




Macro 
Definition 



Generation of 
assembler 
language statements 




MANY 



■f 
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By using the macro facility you reduce programming effort, 
because : 

1. You write and test the code a macro definition contains 
once. You and other programmers can then use the same 
code as often as you like by calling the definition; which 
means that you do not have to reconstruct the coding logic 
each time you use the code. 

2. You need write only one macro instruction to call for 
the generation of many assembler language statements from 
the macro definition. 

When you are designing and writing large assembler language 
programs, the above features allow you to: 

• Prepare macro definitions, containing difficult code, 
for your less experienced colleagues. They can then call 
your definitions to generate the appropriate statements, 
without having to learn the code in the definition. 

• Change the code in one place when updating or making 
corrections, that is, in the macro definition. Each call 
gets the latest version automatically, thus providing 
standard coding conventions and interfaces. 

• Describe the functions of a complete macro definition 
rather than the function of each individual statement it 
contains, thus providing more comprehensible documentation 
for your source module. 
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Defining a Macro 

Defining a macro means preparing the statements that 
constitute a macro definition. To define a macro you must; 

1. Give it a name 

2. Declare any parameters to be used 

3. Write the statements it contains. 

4. Establish its boundaries 












i 


Prototype 


""^ MACRO 


MACID &PARAM1,&PARAM2 




e o 

Body of Macro 






Macro Instruction 


o 




MACID OPERANDI, OPERAND 2 



s 



The MACRO and MEND instructions establish the boundaries 
of a macro definition. 

y- 

You use the prototype statement to name the macro and to 
declare its parameters. In the operand field of the macro 
instruction, you can assign values to the parameters 
declared for the called macro definition. 

The body of a macro definition contains the statements 
that will be generated when you call the macro. These 
statements are called model statements; they are usually 
interspersed with conditional assembly statements or ether 
processing statements. 



©C 



SeeJ2D 



Q l SeeJ3 " 
ft I SeeK2C~ 

©[ 



SeeJ2E 
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WHERE YOU CAN PLACE A MACRO DEFINITION ; You can include 
a macro definition at the beginning of a source module. 
This type of definition is called a source macro definition . 

You can also insert a macro definition in a systeir or user 
library (located, for example, on disk) by using the 
appropriate utility program. This type of definition is 
called a library macro definition . The IBM-supplied macro 
definitions mentioned earlier are examples of library macro 
definitions. 






See JIB 



> 



Source Module 




Generated Result 



■</ 



Macro Library 




SouKe 
Module HI 



Source 
Module I 






Calling a Macro 



You can call a source macro definition only from the source 
module in which it is included. You can call a library 
macro definition from any source module. 



at 
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WHERE YOU CAN CALL A MACRO DEFINITION : You can call a 
macro definition by specifying a macro instruction anywhere 
in a source module , except before or between any source 
macro definitions that may be specified. 



SeeKIB 
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Source 
Module 



Macro Definitions 



Generated 
Result 



MACRO 



MACRO 



OUTER 



OUTER 



sr-i 



INNER 

O s i 




INNER 



^MEND 



MEND 



\ 
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A 


, 


. * 


B 


\ \«^L 


] B. 




L 




M 
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You can also call a macro definition from within another 
macro definition. This type of call is an inner macro 
call; it is said to be nested in the macro definition. 



See K6 A 
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The Conte nts of a Macro Definition 



/f^\ 



The body of a macro definition can contain a combination 
of model statements, processing statements, and comments 
statements. 



Model Statements 

o 



Generated Statements 




BS1E] 



■s 



H^j^ 



^^ MODEL STATEMENTS ; You can write assembler language 

^P statements as model statements . The assembler copies them 

8 exactly as they are written when it expands the macro. 
You can also use variable symbols as points of substitution 
in a model statement. The assembler will enter values 
in place of these points of substitution each time the 
macro is called. 



See J 4 
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The three types of variable symbol in the assembler language 
are 

1. Symbolic parameters, declared in the prototype statement 

2. System variable symbols (see J7) 

3. SET symbols, which are part of the conditional assembly 
language (see L1A) . 

The assembler processes the generated statements, with 
or without value substitution, at assembly time. 

PROCESSING STATEMENTS : Processing statements perform 
functions at pre-assembly time when macros are expanded, 
but they are not themselves generated for further processing 
at assembly time. The processing statements are: 

1. Conditional assembly instructions 

2. Inner macro calls 

3. The MNOTE instruction 

4. The MEXIT instruction. 






Pre-Assembly Time 



\ Macro \ 
\ Definition \ 







MNOTE 




^55^P 



Assembly Time 




Message printed 
in program 
listings 



The MNOTE instruction allows you to generate an error 
message with an error condition code attached, or to 
generate comments in which you can display the results 
of pre-assembly computation. 



SeeJ5D 



> 



^p The MEXIT instruction tells the assembler to stop processing ^M 
a macro definition. The MEXIT instruction therefore ^^ 

©provides an exit from the middle of a macro definition. 
The MEND instruction not only delimits the contents of 
a macro definition but also provides an exit from the 
definition. 



SeeJ5E 



> 
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COMMENTS STATEMENTS : One type of comments statement ^~ 

describes pre-assembly operations and is not generated. 
The other type describes assembly-time operations and is 
therefore generated (for details see J6) . 



The Conditional Assembly Language 

The conditional assembly language is a programming language 
with most of the features that characterize such a language. 
For example, it provides: 

1. Variables 

2. Data attributes 

3. Expression computation 

4. Assignment instructions 

5. Labels for branching 

6. Branching instructions 

7. Substring operators that select characters from a string. 

You can use the conditional assembly language in a macro 
definition to receive input from a calling macro 
instruction. You can produce output from the conditional 
assembly language by using the MNOTE instruction. 

You can use the functions of the conditional assembly 
language to select statements for generation, to determine 
their order of generation, and to perform computations 
that affect the content of the generated statements. 

The conditional assembly language is fully described in 
Section L. 
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Section J: The Macro Definition 



#> 
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This section describes macro definitions: where they can 
be placed in order to be available to call, how they are 
specified, and what they can contain. 



Jl — Using a Macro Definition 



31 A — » PURPOSE 



A macro definition is a named sequence of statements which 
you can call with a macro instruction. When it is called, 
the assembler processes and usually generates assembler 
language statements from the definition into the source 
module. The statements generated can be: 

1. Copied directly from the definition, 

2. Modified by parameter values before generation, or 

3. Manipulated by internal macro processing to change 
the sequence in which they are generated. 

You can define your own macro definitions in which any 
combination of these three processes can occur. Some iracro 
definitions do not generate assembler language statements, 
but perform only internal processing, like some of the 
macro definitions used for system generation. 
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J1B — SPECIFICATIONS 






Where to Define a Macro In a Source 
Module 



A macro definition within a source 
module must be specified at the 
beginning of that source module. 
This type of macro definition is 
called a source macro definition. 
A macro definition can also reside 
in a system library; this type 
of macro is called a library macro 
definition. Either type can be 
called from the source module by 
the appropriate macro instruction. 

NOTE: A source macro definition 
can be entered into a library and 
thereby become a library macro 
definition. A library macro 
definition can be included at the 
beginning of a source module and 
thereby become a source macro 
definition. 

Some control and comments statements 
can appear at the beginning of a 
source module along with the source 
macro definitions. They can be 
used : 

^B Before all macro definitions . 

^ m Between macro definitions . 

tffc After macro definitions and before 
open code 

All other statements of the assembler 
language must appear after any 
source macro definitions that are 
specified. 



Open Code 



Open code is that part cf a source 
module that lies outside of and 
after any source macro definition. 
Open code is initiated by any 
statement of the assembler language 
that appears outside of a macro 
definition, except the ICTL, OPSYN, 
ISEQ, EJECT, PRINT, SPACE, or TITLE 
instruction, or a comments statement. 









Open Code 


e m -i i ^- 
















hlCTLl 
OPSYN 




MACRO 
MACl 

A 

B 

C 
MEND 


■ Must appear ■ 
H first, if spe- 1 
jMcifjej^^^J 


ISEQ 
EJECT 
PRINT 
SPACE 
TITLE 
1 Comments 






MACRO ' 
MAC 2 

MEND 

MACRO 
MACIO 

MEND 




ISEQ 

EJECT 

PRINT 

SPACE 

TITLE 

Comments 




1 






\ \ **Aftf 7 


o 












A 
B 

k C 
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At coding time, it is important 
to distinguish between source 
statements that lie in open code 
and those that lie inside macro 
definitions. 

NOTES: 



1. The ISEQ, EJECT, PRINT, SPACE, 
and TITLE instructions, and one 
or more comments statements , can 
appear between source macro 
definitions and the start of open 
code. However, in this position, 
the above instructions must not 
contain any variable symbols. 

2. After the start of open code, 
variable symbols are allowed in 
any statement. 

3. A macro definition must not be 
specified after the start of open 
code. 



The Format of a Macro Definition 



The general format of a macro 
definition is shown in the figure 
to the right. 

The four parts are described in 
detail below. 



Macro Defn 



MACRO 



(Header Statement) 



| ANYNAME (Prototype Statement) | 



Body of Macro 



MEND 



(Trailer Statement) 
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J2 - Parts of a Macro Definition 






J2A — THE MACRO DEFINITION HEADER 



Purpose 



The macro definition header 
instruction indicates the beginning 
of a macro definition. 



Specifications 



The MACRO instruction is the macro 
definition header; it must be the 
first statement of every macro 
definition. Its format is given 
in the figure to the right. 







Header 


Name 


Operation 


Operand 


Not used, 
must not be 
present 


MACRO 


Not required 



J2B — THE MACRO DEFINITION TRAILER 



Purpose 



"V 



The macro definition trailer 
instruction indicates the end of 
a macro definition. It also provides 
an exit when it is processed during 
macro expansion. 



Specifications 



The MEND instruction statement is 
the macro definition trailer; it 
must be the last statement of every 
macro definition. Its format is 
given in the figure to the right. 







Trailer 


Name 


Operation 


Operand 1 


A sequence 
symbol, or 
not used 


MEND 


Not required 



c 
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J2C — THE MACRO PROTOTYPE STATEMENT: CODING 



Purpose 



The prototype statement in a macro 
definition serves as a model 
(prototype) of the macro instruction 
you use to call the macro definition. 



Specifications 



Prototype 



o 



The prototype statement must be 
the second statement in every macro 
definition. It comes immediately 
after the MACRO instruction. 

The format of the prototype statement 
statement is given in the figure 
to the right. 

The maximum number of symbolic 
parameters allowed in the operand 
field is not fixed .- It depends 
on the amount of virtual storage 
available to the program. 



Name 



A name 
field 

parameter 
or blank 



Operation 



A symbol 




Operand 



Zero or more 
symbolic 
parameters 
separated by 
commas 



If no parameters are specified in 
the operand field, remarks are 
allowed, if the absence of the 
operand entry is indicated by a 
comma preceded and followed by one 
or more blanks. 
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Alternate Ways of Coding the 
Prototype Statement 



The prototype statement can be 
specified in one of the following 
three ways: 

^ The normal way , with all the symbolic 
parameters preceding any remarks. 

^m An alternate way , allowing remarks 
for each parameter. 

^P A combination of the first two ways. 
NOTES: 

1 . Any number of continuation lines 
is allowed. However, each 

O continuation line must be indicated 
by a nonblank character in the column 
after the end column on the preceding 
card. 

2. For each continuation line, the 
operand field entries (symbolic 

©parameters) must begin in the continue 
column otherwise the whole line and 
any lines that follow will be 
tfifc considered to contain remarks. 



Prototype Statements 



Standard value for 
Continue column is 16 



Standard value for 
column after End 
column is 72 



16' 



7172 



MOVE & TO , &FROM , &LENGTH , , &PARAM , 

&PARAM2 , &PARAM3 , &PAR 

REMARKS 



-^^rTj2 ' • ' PARAM15 



Comma required 
after each parameter 
except last 



MOVE 



8|T0> 



< 



& 



FIELD TO WHICH DATA MOVED x 
8JFR0M, FLD. FROM WHICH DATA MVDJX 
8 LENGTH, MOVE LENGTH 



© 



8PARAM1, 
&PARAM2, 



INDEX1 
INDEX2 



5JPARAM15 | REMARKS CONTINUED 
•ON NEXT LINE, 
AND THE NEXT 



Column 16 



\ 



MOVE 



Comma required 
after each 
parameter 
except last 



One or more 
blanks required 



•n 



s|to, *data moved to 

SFROM, DATA MOVED FROM be 
8 LENGTH, NO OF BYTES x 

8 PARAM1 , &PARAM2 , &PARAM3 , |x 

8PARAM15 REMARKS CONTINUED 
ON LAST LINE 



o 



/*~~\ 
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J2D — THE MACRO PROTOTYPE STATEMENT: ENTRIES 



[he Name Entry 



Purpose 



You can write a name-field parameter similar to the symbolic 
parameter, as the name entry of a macro prototype statement. 
You can then assign a value to this parameter from the 
name entry in the calling macro instruction. 
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Specifications 






i 



If used, the name entry must be 
a variable symbol . If this parameter 
also appears in the body of a macro , 
it will be given the value assigned 
to the parameter in the name field 
of the corresponding macrc 
instruction. Note that the value rf 
assigned to the name field parameter 
has special restrictions that are 
listed in K2A. 



The Operation Entry 



Purpose 



The operation entry is a symbol 
that identifies the macro definition. 
When you specify it in the operation 
field of a macro instruct ion „ the 
appropriate macro definition is 
called and processed by the 
assembler. 



e 



Specifications 



The symbol in the operation field 
of the prototype statement 
establishes the name by which a 
macro definition must be called. 
This name becomes the' operation 
code required in any macro instruc- 
tion that calls the macro. 





Source Module MM 






MM MACRO / 




&NAM MOVE^ &TO,&FROM 


P 

&NAM MVC &TO f &FROM 


MEND 
©. START 

HERE MOVE FIELDA,FIELDB 


, \ 


9 

HERE MVC FIELDA,FIELDB 


END 













;: Unless operation codes have 

^|ig-;^atti|a ' r wst;^it opsyr ■".'■' 

instruction, the operation code 
specified in the prototype statement 
must not be the same as that 
specified in: 

1. A machine instruction. 

2. An assembler instruction. 

3. The prototype statement of another 
source (or library) macro definition. 
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The Operand Entry %±_^' 

Purpose 

The operand entry in a prototype statement allows you to 
specify positional or keyword parameters. These parameters 
represent the values you can pass from the calling macro 
instruction to the statements within the body of a macro 
definition. 



Specifications 

The operands of the macro prototype statement must be 
symbolic parameters separated by commas. They can be 
positional parameters or keyword parameters or both (see 
J3) . 

NOTE: The operands must be symbolic parameters; parameters 
in sublists are not allowed. For a discussion of sublist^ 
in macro instruction operands, see Kt. 



J 



Jr 
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J2E — THE BODY OF A MACRO DEFINITION 



Purpose 






The body of a macro definition 
contains the sequence of statements 
that constitutes the working part •* 
of a macro. You can specify: 

1. Model statements to be generated. 

2. Processing statements that, for 
example, can alter the content and 
sequence of the statements generated 
or issue error messages. 

3. Comments statements, some of 
which are generated and others which 
are not. 

H. Conditional assembly instructions 
to compute results tc be displayed 
in the message created by the MNOTE 
instruction; without causing any 
assembler language statements to 
be generated. 



Specifications 



The statements in the body of a 
macro definition must appear between 
the macro prototype statement and 
the MEND statement of the definition. 
The three main types ^f statements 
allowed in the body of a macro are: 

^P • Model statements (see J<4) , 

dlfc • Processing statements (see J5) , 
w and 

C) • Comments statements (see J6) . 

NOTE: The body of a macro definition 
can be empty, that is, contain no 
statements. 

















Result of Macro 
Expansion 




r 






Machine 
Instructions 




Machine 
Instructions 












A 




Assembler 
Instructions 




Assembler 
Instructions 






















Model 
Statements 








Statements with 
variable symbols 
in 

Name,Operation 
and/or Operand 
Fields 












Machine 
Instructions 








K 


— » 




J> 














V 




Assembler 
Instructions 






















** 




Conditional 

Assembly 

Instructions 














Processing 
Statements 
















Macro (Inner) 
Instructions 
























MNOTE 
Instruction 




Message 
















MEXIT 
Instruction 










™ 














Internal 






Comments 
Statements 


















Comments 
Statements 




Ordinary 
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J3 - Symbolic Parameters 



Purpose 



Symbolic parameters allow you to 
pass values into the body of a macro 
definition from the calling macro 
instruction. You declare these 
parameters in the macro prototype 
statement. They can serve as points 
of substitution in the body of the 
macro definition and are replaced 
by the values assigned to them by 
the calling macro instruction. 



© 



By using symbolic parameters with 
meaningful names you can indicate 
the purpose for which the parameters 
(or substituted values) are used. 



Source Module 



MACRO 




OPEN START 



,FROM 



END 



Generated 
Result 






V- 



General Specifications 



Symbolic parameters must be valid 
variable symbols , as shown in the 
figure to the right. 

They have a local scope: that is, 
the value they are assigned only 
applies to the macro definition 
in which they have been declared . 
The value of the parameter remains 
constant throughout the processing 
of the containing macro definition 
for every call on that definition. 

NOTE: Symbolic parameters must 
not be multiply defined or identical 
to any other variable symbols within 
the given local scope. This applies 
to the system variable symbols 
described in J7, and local and 
global SET symbols described in 
L1A. 



& 


p 


J..,. 

ARAM 



"Ampersand 

'Alphabetic character 

'0 to 6 alphameric character 



prototype 



7 



MACRO 



DEFINE &PARAM1 , &PARAM2 , &PARAM3 Q k 



GBLA &A 
LCLC &C 



8 



MEND 



J? 
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The two kinds of symbolic parameters 
are: 



^P • Positional parameters 
^P * Keyword parameters. 



Each positional or keyword parameter 
used in the body of a macro 
definition must be declared in the 
prototype statement . 



© 



Subscripted Symbolic Parameters 



Subscripted symbolic ^parameters 
must be coded in the 'format shown 
in the figure to the right. 

The subscript can be any arithmetic 
expression allowed in the operand 
field of a SETA instruction 
(arithmetic expressions are discussed 
in L4A) . The arithmetic expression 
can contain subscripted variable 
symbols. Subscripts can be nested 
up to 5 levels of nesting. 

The value of the subscript must 
be greater than or equal to one. 
The subscript indicates the position 
of the entry in the sublist that 
is specified as the value of the 
subscripted parameter (sublists 
as values in macro instruction 
operands are fully described in 
M) . 



'^ouTce^oclule' 



Macro 
Definition 



Prototype 



MACRO 



o e 



DEFINED &TO,&FROM= 



MVC 



& TO, & FROM 



Macro 
Instruction 



MEND 
START 



DEFINED 




FIELDA,FROM=FIELDB 



o 



MVC FIELDA,FIELDB 



END 



Source Module 



&PARAM (Subscript) 



Format: 



Variable 
symbol 



Arithmetic 
expression 



MACRO 








SUBLISTS 


&POS,&KEY= 




M¥C 


&POSC 


$),&KEY(3) 




MEND 












e 


\° 


START 










SUBLISTS (A,B,C,D) ,KEY= (E,F,G,H) 




MVC C,G 



END 
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J3A -- POSITIONAL PARAMETERS 



Purpose 



^ 
W 



You should use a positional parameter 
in a macro definition if you wish 
to change the value of the parameter 
each time you call the macro 
definition. This is because it 
is easier to supply the value for 
a positional parameter than for 
a keyword parameter. You only have 
to write the value you wish the 
parameter to have in the proper 
position in the operand of the 
calling macro instruction. 

For keyword (described below) 
parameters, you must write the 
entire keyword and the equal sign 
that precedes the value to be passed. 
However, if you need a large number 
of parameters, you should use keyword 
parameters. The keywords make it 
easier to keep track of the 
individual values you must specify 
at each call, by reminding you which 
parameters are being given values. 



Specifications 



The general specifications for 
symbolic parameters described in 
J3 also apply to positional 
parameters. Note that the 
specification for each positional 
parameter declared in the prototype 
statement definition must be a valid 
variable symbol. Values are assigned 
to the positional parameters by 
the corresponding positional operands 
specified in the macro instruction 
that calls the definition. 











Pos. Param. 




Source Module 




Macro 
Definition 

Macro 
Instruction 


MACRO 


e 


POSPAR 
MEND 


&P] 
/\ 



DNE 


- 


IP2 



?wo 


u 

"I 


&p: 
/\ 

ft 


i 


1 

START 

POSPAR < 
END 




rHF 


tEE 









^ 



J 
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J3B — KEYWORD PARAMETERS 



Purpose 



You should use a keyword parameter 
in a macro definition for a value 
that changes infrequently. Ey 
specifying a standard default value 
to be assigned to the keyword 
parameter, you can oirit the 
corresponding keyword operand in 
the calling macro instruction. 

Keyword parameters are also 
convenient because: 



^k^ 



O 



1. You can specify the corresponding 
keyword operands in any order in 
the calling macro instruction. 

2. The keyword, repeated in the 
operand, reminds you which parameter 
is being given a value and for which 
purpose the parameters is being 
used. 



Specifications 



The general specifications for 
symbolic parameters described in 
J3 also apply to keyword parameters. 
Each keyword parameter must be 
in the format shown isr the figure 
to the right. 

jThe actual parameter must be a valid 
variable symbol . 

A value is assigned to a keyword 
i parameter by the corresponding 
keyword operand through the name 
of the keyword as follows: 

1. If the corresponding keyword 
operand is omitted , the standard 
value specified in the prototype 
statement becomes the value of the 

"parameter for that call (for full 
details on values passed see K5) . 

2. If the corresponding keyword 
operand is specified , the value 
after the equal sign overrides the 
standard value in the prototype 
and becomes the value of the 
parameter for that call (see K5) . 



Key. Param. 




Variable Symbol 



Equal Sign 



Standard Value 



s JKEYWORdI = DEFAULT 



[KEYWORD] = VALUE 

© — 

Example: 

Source Module 



Keyword Parameter 
Specification 

Keyword Operand 
Specification 



A 



MACRO 



"ZZT 



Prototype KEYS &KEYWORD=ABC , &KEY2= (A , B , C ) 



MEND 



START 



Standard value of 
KEYWORD 




Standard value of 
KEY2 



KEY2=(D,E,F) 



END 
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NOTE: A null character string can 
be specified as the standard value 
of a keyword parameter, and will 
be generated if the corresponding 
keyword operand is omitted . 



Source Module 

ir 



Null character 
string 



MACRO 



FXDPT &TYPE^/&REG=3 



L&TYPE &REG,AREA 
AS TYPE & REG, CONST 
ST&TYPE &REG,SUM 



OPEN 



MEND 



START 



FXDPT 




Null character 
string 



7 




Lf 3 ,AREA 
A 3, CONST 
ST 3 , SUM 



FXDPT TYPE=H 




LH 3, AREA 
AH 3, CONST 
STH 3 , SUM 



END 






<_-j 



Xj 
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,T3C ~ COMBINING POSITIONAL AND 
KEYWORD PARAMETERS 



Purpose 



By using positional and keyword 
parameters in a prototype statement, 
you combine the benefits of both. 
You can use positional parameters 
in a macro definition for passing 
values that change frequently and 
keyword parameters for passing 
values that do not change often. 



o • 



Specifications 



Positional and keyword parameters 
can be mixed freely in the macro 
prototype statement . The same 
applies to the positional and keyword 
operands of the macro instruction 
(see K3Q . Note, however, that 
the order in which the positional 
parameters appear determines the 
order in which the positional 
operands must appear. Interspersed 
keyword parameters or operands do 
not affect this order. 





Source Module 

MACRO 



MIX 4P1 , &KEY1=A , &P2 , &P3 , &P4 , &KEY2= , &P5 

© 




MIX KEY1=B, ONE, TWO, THREE, KEY2=3 3, FOUR, FIVE 

o 




END 
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J4 - Model Statements 






JttA — PURPOSE 



Model statements are statements from which assembler 
language statements are generated at pre- assembly time. 
They allow you to determine the form of the statements 
to be generated. Ey specifying variable symbols as points 
of substitution in a model statement, you can vary the 
content of the statements generated from that model 
statement. You can also use model statements into which 
you substitute values in open code. 



J4B — SPECIFICATIONS 



The following specifications also apply to model statements 
in open code. Exceptions are noted where applicable. 



s 



Model Stmnt 



Format of Model Statements 



A model statement consists of one 
or more fields separated by one 
or more blanks. 

Each field or subfield can consist 
of: 

^) An ordinary character string 

A A variable symbol as a point of 
substitution 



Any combination of ordinary 
character strings and variable 
symbols to form a concatenated 
string. 

The statements generated at pre- 
assembly time from model statements 
must be valid machine or assembler 
instructions, but roust not be 
conditional assembly instructions. 
They must obey the coding rules 
described in Section E or they will 
be flagged as an error at assembly 
time. 




Operation 



Operand 



Remarks 





Field or 
Subfield 






1 


1 






Alphameric 
Characters 


W 






Ordinary 
Character 
String 










Special 
Characters 











H~ Variable 
Symbol 



Concatenated 
String 



Examples: 

LABEL L 3, AREA 
LABEL L 3,20(4,5) 
& LABEL L 3, & AREA 
FIELD&A L 3,AREA&C 
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Variable Symbols as Points of 
Substitution 



Values can be substituted for 
variable symbols that appear in 
the name, operation, and operand 
fields of model statements; thus, 
variable symbols represent points 
of substitution. The three main 
types of variable symbol are: 



in 



dfr Symbolic parameters (described 
^ r J3 above) , 

^a System variable symbols (described 
in J7 below) , and 



SET symbols (described in L1A) . 

NOTES: 

1. Symbolic parameters, SET symbols, 
and the system variable symbol , 
CSYSLIST, can all be subscripted. 
The remaining system variable symbols 
fiSYSNDX, 6SYSECT, 6SYSPARM, SSYSDATE , 
and 6SYSTIME cannot be subscripted. 



Format: 




Ampersand 

Alphabetic Character 

to 6 Alphameric Characters 



Variable 
Symbols 



Symbolic 
Parameters 



System 

Variable 

Symbols 



Positional 



Keyword 



Cannot be 
used in 
open code 



&SYSLIST 
&SYSNDX 
&SYSECT 



&SYSPARM 
SDATE 
JME 



Examples of 
Subscripted 
Variable 
Symbols: 

&PARAM(3) 




&SYSLIST(1,3) 
&SYSLIST(2) 



SSETA(IO) 
&SETC(15) 



2. The fields in a statement 
generated from a model statement 
appear in the listings in the same 
columns as in the model statement* 
However, when values are syfestiUfcefl 
for variable symbols the generated 
fields can be displaced to the 
right. 
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Pules for Concatenation 



When variable symbols are 
concatenated to ordinary character 
strings, the following rules apply 
to the use of "the concatenation 
character (a period) : 

The concatenation character is 
mandatory when: 

• An alphameric character is to 
follow a variable symbol. 

• A left parenthesis that does not 
enclose a subscript is to follow 

a variable symbol . 

• A period (.) is to be generated. 
Two periods must be specified in 
the concatenated string following 
a variable symbol. 

The concatenation character is not 
necessary when: 

• An ordinary character string 
precedes a variable symbol. 

• A special character , except left 
parenthesis or period, is to follow 
a variable symbol. 

• A variable symbol follows another 
variable symbol. 

The concatenation character must 
not be used between a variable 
symbol and its subscript ; otherwise, 
the characters will be considered 
a concatenated string and not a 
subscripted variable symbol. 



Concatenated 
String 


Values to be 
Substituted 

Variable Value 
symbol 


Generated 
Result 


&FIELD.A^P 
&FIELDA 


&FIELD AREA 
&FIELDA SUM 


AREAA 
SUM 


e 

& D ISP .(& BASE) 


&DISP 100 
&BASE 10 


100(10), 




Concatenation character is not generated 




DC D*& INT. &FRACT' 

o 


&INT 99 
&FRACT 88 


DC 


D'99.88' 

© 


DC D ' & INT&FRACT * 

o 




DC D'9988' 


DC D'&INT.&FRACT' 
\ -■ 


/ 


DC D'9988' 


\ 


optional 










Concatenation character is not generated 














© 

FIELD&A 
&A+&B*3-D 

© 




&A A 
&A A 
&B B 


FIELDA 
A+B*3-D 


&A&B 

© J 






AB 


&SYM(&SUBSCR)1 


&SUBSCR 10 
&SYM(10) ENTRY 


(entry 



j 4(~\. 



^--j^ 
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Rules for Model Statement Fields 



o 



The fields that can be specified 
in model statements are the same 
fields that can be specified in 
an ordinary assembler language 
statement. They are the name, 
operation, operand and remarks 
fields. It is also possible to 
specify a continuation - indicator •* 
field, an identification - sequence 
field, and a field before the begin 
column, if the appropriate ICTL 
instruction has been specified. 
Character strings in the last three 
fields (in the standard format only 
columns 72 through 80) are generated 
exactly as they appear in the model 
statement, and no values are 
substituted for variable symbols. 

Model statements must have an entry 
in the operation field, and, in 
most cases, an entry in the operand 
field in order to generate valid 
assembler language instructions. 

THE NAME FIELD : The entries allowed 
in the name field of a model 
statement are given in the figure 
to the right, including the allowable 
results of generation. 

Variable symbols roust not be used 
to generate comments statement 
indicators . 

NOTE: Restrictions on the name 
entry are further specified where 
each individual assembler language 
instruction is described in this 
manual. 



Name 
Field 


Allowed 


Not Allowed 


In Model 
Statements 

(before 
generation) 


» blank 

f> ordinary symbol 
|> sequence symbol 
► variable symbol 
|> any combination 
of variable symbols 
and other character 
strings concatenated 
together 




In Generated 
Statements 

(generated 
results) 


» blank 
fe> valid ordinary 
symbol 


o 
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THE OPERATION FIELD; The entries 
allowed in the operation field of 
a model statement are given in the 
figure to the right, including the 
allowable results of generation. 

The operation" codes ICTL and OPSYN 
are not allowed inside a macro 
definition. The MACRO and MEND 
operation codes are not allowed 
in model statements; they are used 
only for delimiting macro 
definitions. 

is not all< 

ittNl 



Operation 
Field 




If the REPRO operation code is 
specified in a model statement, 

Ono substitution is performed for 
the variable symbols in the statement 
line following the REPRO statement. 
Variable symbols can be used alone 
or as part of a concatenated string 
to generate operation codes for: 

^9 • Any machine instruction , or 

^P • The assembler instructions listed. 

A NOTE: The MNOTE and MEXIT statements 
are not model statements; they are 
described in J5D and J5E 
respectively. 

The generated operation code must 
not be an operation code for the 
following (or their OPSYN 
equivalents) : 

^m • A macro instruction , 

^M • A conditional assembly instruction , 
or 

A • The assembler instructions listed. 




In Model 
Statements 



(Before 
Generation) 



In Generated 



Statements 



(Generated 
Results) 



Allowed 



► An ordinar y s ymbol that 
represents the operation 
code for: 

— any machine instruction; 

— a macro instruction 

— the following Assembler 
instructions: 



CCW 

CNOP 

COM 

COPY 

CSECT 

cm 

DC 

DROP 
DS 
DSECT 



EJECT 



ENTRY 

EQU 

EXTRN 

ISEQ 

LTORG 

ORG 

PRINT 
PUNCH 

► A variable symbol 

► A combination of 
variable symbols and 
other characte^strings 
concatenated together 



REPRO 
SPACE 
START 
TITLE 
USING 
WXTRN 
MEXIT \ 
MNOTE J 



Not Allowed 



» blank 

P The assembler 
.. operation codes: 

(ICTL 
lOPSYN 

[MACRO 
IMEJJD 




e 



o 



► An ordinar y s ymbol that 
represents the operation 
code for: 

- any machine instruction 

— the following assembler 

instructions: 



rccw 


EJECT 


CNOP 


IfSSIP- 


COM 


ENTRY 


CSECT 


EQU 


JCX8 


EXTRN 


DC 


LTORG 


DROP 


ORG 


DS 


Wk 


DSECT 


PRINT 


tats 


PUNCH 



SPACE 
TITLE 
USING 
WXTRN 

(MNOTE) 



© © 



» blank 

P a macro instt uction 

operation code 
P a conditional 
assembly operation 
code: 

ACTR GBLA 

AGO GBLB 

AGOB GBLC 

AIF LCLA 

AIFB LCLB 

ANOP LCLC 

SETA 
SETB 
SETC 
^| the following assemblei 
operation codes: 



only 



© 



J 



COPY 

ICTL 

ISEQ 

MACRO 

MEND 



MEXIT 
OPSYN 
REPRO 
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THE OPERAND FIELD: The entries 
allowed in the operand field of 
a model statement are given in the 
figure to the right, including the 
allowable results of generation. 

NOTE: Variable symbols must not 
be used in the operand field of 
a COPY, ICTL, ISEQ, or OPSYN 
instruction. 



Operand 
Field 


Allowed 


Not Allowed 


In Model 
Statements 


*• Blank (if valid) 
> An ordinary symbol 




(Before 
Generation) 


> A charter spring, 
combining alphameric 
and special charac- 
ters (but not variable 
symbols) 

» A variable symbol 

^ A combination of 
variable symbols and 
other character 
strings concatenated 
together 




In Generated 
Statements 


> blank (if valid) 


> operand field of at 
COPY, ICTL, 




>■ Character Strina 


ISEQ or OPSYN 


(Generated 


that represents a 


statement 


Results) 


valid assembler or 






machine instruction 


O 




operand field 



c 



THE REMARKS FIELD : Any combination 
of characters can be specified in 

Othe remarks field of a model 
st at ement . Wo values are substituted 
into variable symbols in this field. 

NOTE: One or more blanks must be 
used in a model statement to separate 
^fr the name y operation, operand, and 
remarks fields from each other. 
Blanks cannot be generated between 
fields in order to create a complete 
assembler language statement. 

lore ^ 
l$«nfc9 to **] : 






Remarks Field 



Model 
&NAME 



Generated 

LABEL 




&OP» &TO,& FROM* REMARKS ABOUT &TO 
MVC FIELDA,FIELBB REMARKS ABOUT &T0 



Example I: 

&ADDR 
Model 

Generated 



LCLC &ADDR Conditional 

> Assembly 
SETC '100 ^PERCENT BASE * Statements 



LA 3 , &ADDR 




One or more blanks 
must be generated 



LA 3 1 100 ▼ PERCENT BASE 

e 



Example II: 

&A 
&C 

Model 



LCLA &A 

LCLC &C 

SETA 100 

SETC '&A &A NOW IN REGISTER 1 

LA 3,&C LOOK HERE 



Additional remarks 



and remarks combined 

toeratedLn^WOJjOOO^INJ 
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J5 - Processing Statements 



J5A ~ CONDITIONAL ASSEMBLY 
INSTRUCTIONS 

Conditional assembly instructions 
allow you to determine at pre- 
assembly time the content of the 
generated statements and the sequence 
in which they are generated. The 
instructions and their functions 
are given in the figure to the 
right. 

Conditional assembly instructions 
can be used both inside macro 
definitions and in open code. They 
are fully described in Section L. 



Conditional Assembly 
Instruction 


Function Performed 


GBLA,GBLB,GBLC 
LCLA,LCLB,LCLC 


Declaration of initial values 
of variable symbols (global 
and local SET symbols) 


SETA,SETB,SETC 


Assignment of values to 
variable symbols (SET 
symbols) 


AIF 

AGO 
ANOP 


Branching 

— Conditional (based on 

logical test) 

— Unconditional 

— To next Sequential 

instruction (No 
operation) 


'\CTR 


Setting Lood Counter 






J5B ~ INN ER MACRO INSTRUCTIONS 



Macro instructions can be nested inside macro definitions, 
allowing you to call other macros from within your own 
definitions. Nesting of macro instructions is fully 
described in K6 . 



\4___y 



J5C — THE COPY INSTRUCTION 



Purpose 



The COPY instruction, inside macro definitions, allows 
you to copy into the macro definition any sequence of 
statements allowed in the body of a macro definition. 
These statements become part of the body of the macro 
before macro processing takes place. You can also use 
the COPY instruction to copy complete macro definitions 
into the beginning of a source module. 

The specifications for the COPY instruction, which can 
also be used in open code, are described in E1A. 



272 



J5D — THE MNOTE INSTRUCTION 



Purpose 



You can use the MNOTE instruction 
to generate your ovm error messages 
or display intermediate values of 
variable symbols computed at pre- 
assembly time. 



Specifications 



JF\ 



The MNOTE instruction can be used 
inside macro definitions pfc. ^^$|$g|f 

and its operation code can 
be created by substitution. The 
MNOTE instruction causes the 
generation of a message which is 
given a statement number in the 
printed listing. 

The format of the MNOTE instruction 
statement is given in the figure 
to the right. 



f Tne n stands for a severity code . 
The rules for specifying the contents 
of the severity code subfield are 
as follows: 

1. The severity code can be specified 
f as any arithmetic expression allowed 
in the operand field of a SETA 
instruction. The expression must 
have a value in the range through 
255. 

) 2. If the severity code is omitted , 
but the comma separating it from 
the message is present, the assembler 
assigns a default value of 1 as 
the severity code. 

I 3. An asterisk in the severity code 
subfield causes the message and 
the asterisk to be generated as 
a comments statement. 

l. 4. If the entire severity code 
subfield is omitted , including the 
comma separating it from the message, 
the assembler generates the message 
as a comments statement. 











MNOTE 


Name 


Operation 


Operand 


A sequence 


MNOTE 


One of four options allowed: 


symbol or 




4^k n, 'message' 1 error 
^^ /message' j message 


blank 








Vmessage; \ ^^^ 
message J 


Examples: 


Source Statements 


Generated Result 


© 








MNOTE 2 , 


•ERROR IN SYNT, 


AX* 


2, ERROR IN SYNTAX 


© 








MNOTE , ' 


ERROR, SEV 1' 




, ERROR, SEV 1 


© 








MNOTE * , ' 


NO ERROR' 




*,N0 ERROR 


© 

MNOTE ' N< 


D ERROR' 


- 


NO ERROP 
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NOTES: 

1. An MNOTE instruction causes a message to be printed, 

if the current PRINT option is ON, even if the PRINT NOGEN 
option is specified. 

2. The statement number of the message generated from an 
MNOTE instruction with a severity code is listed among 
any other error messages for the current source module. 
However, the message is printed only if the severity code 
specified is greater than or equal to the severity code 
•nnn" in the assembler option , FLAG (nnn) , contained in 
the EXEC statement that invokes the assembler. 




3. The statement number of the comments generated froir 

an MNOTE instruction without a severity code is not listed 

among other error messages. 



Any combination of up to 256 characters enclosed in 
apostrophes can be specified in the message subfield. 
The rules that apply to this character string are as 
follows : 



• 



A* Variable symbols are allowed (NOTE: variable symbols 
^^ can have a value that includes even the enclosing 
apostrophes) . 

%B • Double ampersands and double apostrophes are needed ^p 
to generate one ampersand or one apostrophe. If variable 

O symbols have ampersands or apostrophes as values, the 
values must have double ampersands or apostrophes . 

NOTE: 

Any remarks for the MNOTE instruction statement must 
be separated from the apostrophe that ends the message 
by one or more blanks. 



vy 
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\J) 



> 



Severity Code 



MNOTE Operand 



T. 



Value of 
Variable Symbol 



Generated 
Result 



3,' THIS IS A MESSAGE' 
3 , &PARAM 




3,' VALUE OF &&A IS &A' 



&PARAM=ERROR 



&A=10 



3, THIS IS A MESSAGE 
3 .ERROR 

3, VALUE OF &A IS 1Q 



3,'L"&AREA' O 
3, 'DOUBLE SAMPS' 

3 /DOUBLE L&APOS&AREA' 



&AREA=FIELD1 
&AMPS=&,& 



* 



&APOS=" 
&AREA=FIELD1 



3,L'FIELD1 
3, DOUBLE & 

3 .DOUBLE L'FIELDl 



3, 'MESSAGE 


STOP' FID* 




Invalid remarks, 
must be separated 
from operand by . 
one or more blanks 


3 'MESSAGE 


stop" *ptiftg' 




Valid Remarks 
entry 



3 .MESSAGE STOP RMRKS 
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J5E — THE MEXIT INSTRUCTION 



/ T X , 



MEXIT 



.,> 



Purpose 



The MEXIT instruction allows you 
to provide an exit for the assembler 
from any point in the body of a 
macro definition. The MEND 
instruction provides an exit only 
from the end of a macro definition 
(see J2B) . 



Specifications 



The MEXIT instruction statement 
can be used only inside macro 
definitions. It has the format 
given in the figure to the right. 

The MEXIT instruction causes the 
assembler to exit from a macro 
definition to the next sequential 
instruction after the macro 
instruction that calls the 
definition. (This also applies 
to nested macro instructions, which 
are described in K6.) 



Name 



Sequence 
symbol 
or blank 



Operation 



MEXIT 



Operand 



Not requirec 



MACRO 



EXITS 

A 

B 

C 

MEXIT 



MEND 



START 



EXITS 



w 




"■■fly 
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J6 - Comments Statements 



J6A — INTERNAL MACRO COMMENTS STATEMENTS 



Purpose 



You write internal macro comments in the body of a macro 
definition, to describe the operations performed at pre- 
assembly time when the macro is processed. 






Specifications 



Internal macro comments statements 
can be used only inside macro 
definitions. An example of their 
correct use is given in the figure 
to the right. 

No values are substituted for any 
variable symbols that are specified 
in macro comments statements. 







Begin column 
(standard 
value) 






Columns 


/ 

(1) 

• 
• 


(2) 

* 
* 


(3) 


/ ' Period, 

r— —Asterisk 

* Any Character String 


format 


•this comment will not be. 
generated 



J6B — ORDINARY COMMENTS STATEMENTS 



Purpose 



Ordinary comments statements 
(described in E1C) allow you to 
make descriptive remarks about the 
generated output from a macro 
definition. 



Specifications 



Ordinary comments statements can 
be used in macro definitions and 
in open code. An example of their 
correct use is shown in the figure 
to the right. 

Even though this type of statement 
is generated along with the model 
statements of a macro definition, 
values ar§ not .substituted for any 
variable symbols specified. 















Begin column 
(standard 
value) 




Columns 


I 

(1) 
* 


(2) 


—Asterisk 

—Any Character String 


Format 


tftlS COMMENT WILL BE 


GENERATED 
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J7 - System Variable Symbols v^ y 

Purpose 

System variable symbols are variable symbols whose values 
are set by the assembler according to specific rules. 
You can use these symbols as points of substitution in 
model statements and conditional assembly instructions. 



General Specifications for System Variable Symbols 

'. jp§§ The system variable symbols: *SYSDAT1« 6SYSPARM, and 

1&&&- fSYSTlMB^ can be used as points of substitution both inside 

macro definitions and in open code. The remaining system 

variable symbols: SSYSECT, SSYSLIST, and 6SYSNDX, can be 

used only inside macro definitions. All system variable 

symbols are subject to the same rules of concatenation / 

and substitution as other variable symbols (see J4B) . 

System variable symbols must not be used as symbolic 
parameters in the macro prototype statement. Also, they 
must not be declared as SET symbols (see L2) . 

The assembler assigns read-only values to system variable N 

symbols; they cannot be changed by using the SETA, SETB, / 

or SETC instructions (see L3) . %S' 
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Syst. Var. Sym. 



OS 



8 



o 



THE SCOPE OF SYSTEM VftRIAELE SYMBOLS ; 
The system variable symbols: 
fcSYSDATE, SSYSPARM, and fSYSTIME, 
have a global scope. This means 
that they are assigned a read-only 
value for an entire source module; 
a value that is the same throughout 
open code and inside any macro 
definitions called. The system 
variable symbols: 6SYSEC1, 6SYSLIST, 
and SSYSNDX, have a local scope. 
They are assigned a read-only value 
each time a macro is called, and 
have that value only within the 
expansion of the called macro . 



$?&-<— &SYSDATE 



Source Module 




NOTE: 

&SYSECT 

&SYSLIST 

&SYSNDX 

are only allowed 
inside macro 
definitions 



Purpose 



&SYSDATE 



o 



You can use SSYSDATE tc obtain the 
date on which your source module 
is assembled. 



Specifications 



The global system variable symbol 
6SYSDATE is assigned a read-only 
value of the format given in the 
figure to the right. 

NOTE: The value of the type attribute 
of 6SYSDATE (T 1 SSYSEATE) is always 
U and the value of the count 
attribute (K'SSYSDATE) is always 
eight. (Attributes are fully 
described in L1B.) 



Format: 
Where: 



Example: 



8 - Character String 



mm/dd/yy 



mm gives the month 
dd gives the day 
yy gives the year 



11/25/72 



Corresponds to date 
printed in the page 
heading of listings, 
remains constant for 
each assembly 
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J7B — SSYSECT 






Purpose 



You can use SSYSECT in a iracro 
definition to generate the name 
of the current control section. 
The current control section is the 
control section in which the macro 
instruction that calls the definition 
appears. 



&SYSECT 



O 





o 
e 



OS 

only 



Specifications 



The local system variable symbol 
SSYSECT is assigned a read-only 
value each time a macro definition 
is called. 

The value assigned is the symbol 
that represents the name of the 
current control section from which 
the macro definition is called. 
Note that it is the ccntrcl section 
in effect when the macro is called. 
A control section that has been 
initiated or continued by 
substitution does net affect the 
value of SSYSECT for the expansion 
of the current macro. However, 
it does affect SSYSECT for a 
subsequent macro call . Nested 
macros cause the assembler to assign 
a value to SSYSECT that depends 
on the control section in force 
inside the outer macro when the 
inner macro is called (see K6) . 

NOTES: 

1. The control section whose name 

is assigned to SSYSECT can be defined 
by a START, CSECT, CSECT, or COM 
instruction. 

2. The value of the type attribute 
of SSYSECT, T* SSYSECT, is always 
U, and the value of the count « 
attribute (X* *SY is equal ^fjl 
the number of characters assigned 
aa a value to fSYSBG$# (Attributes 
are fully described in L1E. ) 



Source Module 



MACRO 





OUTER 


&NAME 


&NAME 


CSECT 






DC 


A (SSYSECT) 




INNER 





MEND 



MACRO 



INNER 



DC A(&SYSECT) 



MEND 




> 
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J7C — CSYSLIST 



Purpose 



You can use SSYSLIST instead of 
a positional parameter inside a 
macro definition, for example, as 
a point of substitution. Ey varying j 
the subscripts attached to SSYSLIST, 
you can refer to any positional 
operand or sublist entry in a macro 
call. SSYSLIST allows you to refer 
to positional operands for which 
no corresponding positional parameter 
is specified in the macro prototype 
statement. 



Specifications 






The local system variable symbol 
6SYSLIST is assigned a read-only 
value each time a macro definition 
is called. 

6SYSLIST refers to the complete 
list of positional operands specified 
in a macro instruction. SSYSLIST 
does not refer to keyword operands. 

However, SSYSLIST cannot be specified 
as 6SYSLIST alone. One of the two 
forms given in the figure to the 
right must be used as a point of 
substitution : 

^m 1. To refer to a positional operand 



&SYSLIST 



e 



2. To refer to a sublist entry of 
a positional operand (sublists are 
fully described in K4 below) . 

KB The subscript n indicates the 

©position of the operand referred 
to. The subscript m , if specified, 
indicates the position of an entry 
in the sublist specified in the 
operand whose position is indicated 
by the first subscript n. 



Macro 

Instruction ^y^ 

MACLST C P1,P2,P3, 



SSYSLIST 



Point of substitution 
in macro definition 



Macro 
Instruction 

KACSUB f Pl,P2, 



Pn 



o 



&SYSLIST(n) 

© 



SSYSLIST 



&SYSLIST(n) 



,'(SE1,SE2, . „ . ,SEm, 




Point of substitution 
in macro definition 



&SYSLIST(n,m) 

0© 
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The subscripts n and rn can be any 
arithmetic expression allowed in 
the operand of a SETA instruction 
(see L3A) . The subscript n must 
be greater than or equal to 0. 
The subscript m must be greater 
than or equal to 1 . 

The figure to the right shows 
examples of the values assigned 
to 6SYSLIST according to the value 
of its subscript, m and n. 

If the position indicated by n 
refers to an omitted operand or 
refers past the end of the list 
of positional operands specified, 
the null character string is 
substituted for SSYSLIST (n) . If 
the position (in a sublist) indicated 
by the second subscript, m, refers 
to an omitted entry or refers past 
the end of the list of entries 
specified in the sublist referred 
to by the first subscript, n, the 
null character string is substituted 
for SSYSLIST (n,m) . Further, if 
the nth positional operand is not 
a sublist, SSYSLIST (n,1) refers 
to the operand but SSYSLIST (n,m) , 
where m is greater than 1 , will 
cause the null character string 
to be substituted. 

NOTE: If the value of subscript 
n is zero , then SSYSIIST (n) is 
assigned the value specified in 
the name field of the macro 
instruction, except when it is a 
sequence symbol. 



Macro Instruction: 




NAME MACALL ONE, TWO, (3 


,4,, 6) , , EIGHT 


Point of substitution 


Value 


in macro definition 


Substituted 


&SYSLIST(2) 
&SYSLIST(3,2) 


two" 

4 


o 

&SYSLIST(4) 


NUll 


© 

&SYSLISTO) 


Null 


© 

&SYSLIST(3,3) 


Null 


© 

&SYSLIST(3,5) 


Null 


© 

&SYSLIST(2,1) 


TWO 


&SYSLIST(2,2) 


Null 


© 

&SYSLIST(0) 


NAME 


&SYSLIST(3) 


(3,4, ,6) 
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Attribute references can be made 
to the previously described forms 
of SSYSLIST. The attributes will 
be the attributes inherent in the 
positional operands or sublist 
entries to which you refer. 
(Attributes are fully described 
in L1E.) However, the number 
attribute of SSYSLIST, N'SSYSLIST, 
is different from the number 
attribute described in L1B. One ^ 
of the two forms given in the figure 
to the right can be used for the 
number attribute: 

• To indicate the number of 
positional operands specified in 
a call 

• To indicate the number of sublist 
entries that have been specified 

in a positional operand indicated 
1 bv the subscript . 

NOTES : 

1. For N'SSYSLIST, positional 

! operands are counted if specifically 
omitted by specifying the comma 
that would normally have followed 
the operand. 

2. For N*6SYSLIST (n) , sublist entries 
are counted if specifically omitted 
by specifying the comma that would 
normally have followed the entry. 

3. If the operand indicated by n 
is not a sublist . N* 6SYSLIST (n) 
is 1 . If it is omitted . 
N'gSYSLlSTfn) is zero. 



^Pn'&syslist 


Macro 
Instruction 


Value of 
N'&SYSLIST 


MACLST 
MACLST 
MACLST 
MACLST 

MACLST 
MACLST 
MACLST 


1,2,3,4 
A,B, ,D,E 
,A,B,C,D 
(A,B,C) ,(D,E,F) 

KEY1=A,KEY2=B 
A,B,KEY1=C 


4 

5' 
5 
2 


1© 


Counts sublists 
as one operand 




2 




Keyword operands 
are not counted 






^TN'&SYSLIST(n) 


Macro £L 
Instruction ^m 


Value of 
N'&SYSLIST (2) 


MACSUB 
MACSUB 
MACSUB 
MACSUB 

MACSUB 
MACSUB 

MACSUB 


(n=2) 

A, (1,2, 3, 4, 5), B 
A,(1,,3,,5),B 
A, (,2,3,4,5) ,B 
A,B,C 

a\ ,c 

A,KE¥=(A,B,C) 


1© 

1 






o 


Keyword sublists 
are not counted 
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J7D — SSYSNDX 
Purpose 



/ /fT~>!\ 



You can attadh SSYSNDX to the end of a symbol inside a 
macro definition to generate a unique suffix for that 
symbol each time you call the definition. Although the 
same symbol is generated by two or more calls to the same 
definition, the suffix provided by SSYSNDX produces two 
or more unique symbols. Thus you avoid an error being 
flagged for multiply defined symbols. 



&SYSNDX 



Specifications 



The local system variable symbol 
SSYSNDX is assigned a read-only 
value each time a macro definition 
is called from a source module. 



(P The value assigned to SSYSNDX is 
a 1-digit number, starting at 0001 
for the first macro called by a 
0fr program. It is incremented by one 
^^ for each subsequent macro call 
(including nested macro calls, 
described in K6) . 

NOTES : 

1. SSYSNDX does not generate a valid 
symbol, and it must: 

O a * Follow the symbol to which 
it is concatenated 

b. Be concatenated to a symbol 

©containing four characters or 
less . 

2. The value of the type attribute 
of SSYSNDX (T* SSYSNDX) is always 
N, and the value of the count 
attribute (K* SSYSNDX) is always 
four. 

(Attributes are fully described 
in L1B.) 

J7E — SSYSPARM 



Purpose 



Source Module 





MACRO 






CONST 


&P1 ; &P2 


&P1&SYSNDX 


DC 


F'&P2' 


© 






AREAS SYSNDX 


ps 


F 



MEND 



OPEN 



START 



CONST TWO , 2 



NOTE: 

TWOOOIOand 
TWO 0011 are 
two different 
symbols and 
thus not mul- 
tiply defined 




Assume 

&SYSNDX-0009 

here 




.TWO0010 DC F'2' 
AREA0010 DS F 



CONST TWO, 200 



■TWO0011 DC F'200' 
AREA0011 DS F 



CONST THREE. 300 



j * ERROR 




iTHREE0012i DC F'300' 
AREA0012 DS F 



W_i 



You can use SSYSPARM to communicate with an assembler 
source module through the job control language. Through 
SSYSPARM, you pass a character string into the source 
module to be "assembled from a job control language statement 
or from a program that dynamically invokes the assembler. 
Thus, you can set a character value from outside a source 
module and then examine it as part of the source module 
at pre-assembly time, during conditional assembly 
processing. 
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Specifications 



The global system variable symbol 
SSYSPARtf is assigned a read-only 
value in a job control statement 
or in a field set up by a program 
that dynamically invokes the 
assembler. It is treated as a „ 
global SETC symbol in a source 
module, except that its value 
cannot be changed. 

The largest value that SSYSPARM can 
hold when you code your own 
procedure is 91 characters, which 
can be specified by an invoking 
program. However, if the PARM field 
of the EXEC statement is used to 
specify its value, the PARM field 
restrictions reduce its maximum 
possible length. 



&SYSPARM 



Under CMS, the option line of 
ASSEMBLE command cannot exceed t$G 
characters , thus limiting the ntMfcec* 

Of characters you can specify ftar, 
tes*ARM»-':''.M ■■;;,; 'M^^^M" "" "* 



She largest value 
is 8 characters. 

NOTES : 



tstsmm tm 11013 



1. No values are substituted for 
variable symbols in the specified 
value; however, double ampersands 
must be used to represent single 
ampersands in the value. 

I CMS since CMS does not strip amper- 
sands from the variable symbol* 
you need not specify double 
ampersands for CMS. 



Example: 



Job Control Statement 



//STEP EXEC ASMFC , PARM= (SYSPARM (DEBUG) ) 




Source Module 



OPEN 



START 



AIF ('& SYSPARM' NE 'DEBUG'). SKIP. 




.SKIP 



ANOP * 



Branch to normal 
conditional assembly 
processing if &SYSPARM 
is hot equal to DEBUG 



END 




2. Double apostrophes are needed 
to represent single apostrophes 
because the entire PARM field 
specification is enclosed in 
apostrophes. 



dWS since CMS does not strip single 
apostrophes from the variable 
symbol, you need not specify 
double apostrophes for CMS. 
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3. If SYSPARM is net specified in 
a job control statement outside 
the source module, SSYSPARM is 
assigned a default value of the 
null character string. 

*i The value., of the type attr ifeutfc 
of SSYSPJOtM f$MSYSPAR«| i* *i***Yj| 
0, while the value of the count 
attribute IK* ISYSPARtil i» tfasyn 
of characters spec! flea foe StSP 
in a job control statement or in 
a field set up by a program that 
dynamically invokes the assembler* <p 
Double apostrophes and double ft 
ampersands count as one character. % 

cms 5. cms parses the command line, 
' breaking the input into eight- 
character tokens r therefore, the 
SYSPARM option field under VM/S70 
is limited to an eight- character 
field. If you want to enter larger 
fields or if you want to enter 
parentheses or embedded blanks, you 
must enter the special symbol •?• 
(the question mark symbol) in the 
option field. When CMS encounters 
this symbol in the command line, it 
will prompt you with the message 
ENTER SYSPARM:, after which you may 
enter any characters you want up to 
the option line limit of tOO < ■ i 
characters. The following code is 
an example of how to use the ? 
symbol in the SYSPARM field? 

assemble test (load deck sysparm (^ 

ENTER SYSPARM s 
6 Sam,' bo) .fy 



R; 
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Purpose 



You can use SSYSTIME to obtain the 
time at which your source module 
is -assembled. 



Specifications 



The global system variable symbol 
SSYSTIME is assigned a read-only 
value of the format given in the 
figure to the right. 

NOTES : 

1. The value of the type attribute 
of SSYSTIME (T* SSYSTIME) is always 
U and the value of the count 
attribute (K f SSYSTIME) is always 
5. 

2. For systems without the internal 
timer feature, SSYSTIME is a 5- 
character string of blanks. 



'O 







&SYSTIME 


Format: 
Where: 
Example: 


5 - Character String 

/ 

in «mm 

hh gives the hours 
mm gives the minutes 

22.15 r-*-^_ 


-~S 10.15 p.m. 


Corresponds to the 
time printed in the 
page heading of 
listings, remains 
constant for each 
assembly 






In addition to the PRINT options that you can set froir 
inside a source module, you can set other listing options 
from outside a source module by using the job control 
language. These options can be specified in the PARM field 
of the EXEC statement or by a program that dynamically 
invokes the assembler. 



J8A — LIEMAC 



Purpose 



The LIBMAC option allows you to print in the program 
listings the library macro definitions called from your 
source module , and any statements in open code following 
the first END statement (coded or generated) that is 
processed by the assembler. 
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Specifications 



The HBMAC option, when set, causes: 

^P Any statements in open code that 
follow the first END statement and 

^P All library macro definitions called 
to be printed in the program listings 
after the first (or only) END 
statement of the source module. 

Q NOTE: Multiple END statements can 
be coded or generated and are 
printed, but the first END statement 
processed ends the assembly. 

The option NOLIBMAC suppresses the 
listing of the items mentioned 
above. It is the default option 
that applies to the assembling of 
source modules. 



J8B — MCALL 



Purpose 



The MCALL option allows you to list 
all the inner macro instructions 
that the assembler processes. 



Specifications 



Sourc^Moaule 







MACRO 



MAC1 



MEND 
MACRO 



MAC 2 



MEND 



OPEN 



START 



LINK 



•/ 




Source m 

Macro 

Definitions 



OPEN 




END 



MACRO 




LINK 




MEND 
MACRO 


e 


OPEN 




MEND 





v> 



The MCALL option, when set, causes 
all inner macro instructions 
processed by the assembler to be 
listed. The NOMCALL option 
suppresses the listing of inner 
macro instructions. It is the 
default option that applies to the 
assembling of ; source modules. 

NOTE: The MLOGIC and ALOGIC options 
concern the listing of conditional 
assembly statements. They are 
discussed in L8. 
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Section K: The Macro Instruction 



This section describes macro instructions: where they 
can be used and how they are specified, including details 
on "the name, operation, and operand entries, and what will 
be generated as a result of that macro call. 

After studying this section, you should be able to use 
the macro instructions correctly to call the macro 
definitions that you write. You will also have a better 
understanding of what to specify when you call a macro 
and what will be generated as a result of that call. 



Kl - Using a Macro Instruction 



K1A — PURPOSE 






The macro instruction provides the assembler with: 

1. The name of the macro definition to be processed. 

2. The information or values to be passed to the roacrc 
definition. This information is the input to a macro 
definition. The assembler uses the information either 
in processing the macro definition or for substituting 
values into a model statement in the definition. 

The output from a macro definition, called by a macro 
instruction, can be: 

/■ 

1. A sequence of statements generated from the model 
statements of the macro for further processing at asseirbly 
time. 

2. Values assigned to global SET symbols. These values 
can be used in other macro definitions and in open code 

(see L1AJ . 



! 
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K1B — SPECIFICATIONS 



Where Macro Instructions Can Appear 



A macro instruction can be written 
anywhere in the open code portion 
of a source module. However, the 
statements generated from the called 
macro definition must be valid 
assembler language instructions 
and allowed where the calling macro 
instruction appears. A macro 
instruction is not allowed before 
or between any source macro 
definitions, if specified, but it 
can be nested inside a macro 
definition (see K6) . 



O 



Macro Instruction Format 



The format of a macro instruction 
statement is given in the figure 
to the right. 

The maximum number! of operands 
allowed is not fixed. It depends 
on the amount of virtual storage 
available to the program. 







Source Module 














> 


Source 
' Macro 
Definitions 






MACRO 
MACl 




^ 




MEND 


% 


MACRO 
MAC 2 

MEND / 


f 

O 


f 


s MACRO 
\ MAC3 

MEND 




> 


i _ „ — 

H fC C A L 

A START 

MACCALL 

MACCALL 

• 

END 


llliii 




e 


Must not cause generation 
of instructions that are not 
allowed before the START 
instruction 



















V_#y 



If no operands are specified in 
the operand field, remarks are 
allowed if the absence of the operand 
entry is indicated by a comma 
preceded and followed by one or 
more blanks. " 

The entries in the name, operation, 
and operand fields correspond to 
entries in the prototype statement 
of the called macro definition (see 
K2) . 









Macro Inst. 


Name 


Operation 


Operand 


Any symbol 
or blank 


Symbolic 
Operation 
Code 


Zero or more operands 
separated by commas 
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alternate Ways of Ceding a Macro 
Instruction 



A macro instruction can be specified 
in one of the three following ways: 

OThe norrral way , with the operands 
preceding any remarks. 

^h The alternate way , allowing remarks 
^^ for each operand. 

dfr A combination of the first two 
^^ ways. 

NOTES: 

1 . Any number of continuation lines 

Oare allowed. However, each 
continuation line must be indicated 
ty a non-blank character in the 
column after the end column of the 
previous statement line (see B1B) . 

2. Operands on continuation lines 
must begin in the continue column , 
or 

3. Otherwise, the assembler assumes 

©that any lines that follow contain 
remarks . 

NOTE: If any entries are made in 
the columns before the continue 
column in continuation lines, the 
assembler issues an error message 
and the whole statement is not 
processed. 



col 16 



MACNORM 



col 72 



MACALT 



One or 

more 

blanks 



TO,^ FIELD INTO WHICH DATA MOVED x 
FROM,^ . FIELD FROM WHICH DATA MOVED x 



MACOMB 



© 



TO , FROM, LENGTH ,P 4, P5 , . . . 
P7,P8, ,PEND .REMARKS 



,P6,x 



Begin Continuation 
Line Here 



One or More 
Blanks 



/ 



Do not 
forget 



Commas indicate 
more operands 
to follow 



LENGTH, T NUMBER OF BYTES TO MOVE 

P4 , REMARKS 
P5, REMARKS 



P6 , REMARKS 
P7 , REMARKS 
P8 , REMARKS 
KEY=VALUE > EVEN KEYWORD OPERANDS 



/ 



Last Operand requires no 
comma, but, if a comma is 
used, no error will occur. 



Note: Last line 



One or 
more blanks 



TO, FROM, LENGTH, 
P4 , REMARKS 
P5, REMARKS 

P6,P7, 

*P10,PEND 



REMARKS 



x 

X 

,P8,P9,x 
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K2 - Entries 



K2A — THE NAME ENTRY 



Purpose 



You can use the name entry of a 
macro instruction: 

1. Either to generate an assembly- 
time label for a machine or assembler 
instruction. 

2. Or to provide a conditional 
assembly label (see sequence symbol 
in L1C) so that you can branch to 
the macro instruction at pre- assembly 
time if you want the called macro 
definition expanded. 



Specifications 



The name entry of a macro instruction 
can be: 

^fc an ordinary symbol 
4v a var J- ap ^ e symbol 

Oa character string in which a 
variable symbol is concatenated 
to other characters 

mm a blank 



0a sequence symbol, which is never 
generated. 



MEND 



OPEN START 



MACNAM 




Parameter must be 
coded if anything 
is to be generated 



In Two Places 



In name field 
of prototype 



In name field of 
statement within 
body of macro 




Generated result 



HERE LR 3,4 



Generated result must 
be a valid symbol or 
blank 



LR 3,4 



LR 3,4 



LR 3,4 



0EH 



Nothing will be generated 
by sequence symbol 



LR 3,4 



END 



J 



292 



K2B — THE OPERATION ENTRY 



Purpose 



The symbolic operation code you 
specify identifies the macro 
definition you wish the assembler 
to process. 



Specifications 



f\ 



The operation entry for a macro 
instruction must be a valid symbol 
that is identical to the symbolic 
operation code specified in the 
prototype statement of the macro 
definition called. 

NOTE: If a source iracrc definition 
with the same operation code as 
a library macro definition is called, 
the assembler processes the source 
macro definition. 



K2C — THE CPERANE ENTRY 



Purpose 



You can use the operand entry of 
a macro instruction to pass values 
into the called macro definition. 
These values can be passed through: 

1. The symbolic parameters you have 
specified in the macro prototype, 
or 

2. The system variable symbol 
6SYSLIST if it is specified in the 
body of the macro definition (see 
J7C) . 

The two types of operands allowed 
in a macro instruction are the 
positional operand and the keyword 
operand (see K3) . You can specify 
a sublist with multiple values in 
both types of operands (see K4) . 
Special rules for the various values 
you can specify in operands are 
given in K5. 



Source Module 



MACRO 



CALLED 



System Library 


Containing Library Macros 
yC G e // 

u L • E • • p • U 1/ 

T E T 
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K3~ Operands 



K3A — POSITIONAL OPERANDS 



Purpose 



You can use a positional operand to pass a value into a 
macro definition through the corresponding positional 
parameter declared for the definition. You should declare 
a positional parameter in a macro definition when you wish 
to change the value passed at every call to that macro 
definition. 

You can also use a positional operand to pass a value to 
the system variable symbol 6SYSLIST. If 6SYSLIST, with 
the appropriate subscripts, is specified in a macro 
definition, you do not need to declare positional parameters 
in the prototype statement of the macro definition. Ycu ^ 
can thus use SSYSLIST to refer to any positional operand. 
This allows you to vary the number of operands you specify 
each time you call the same macro definition. The use 
of SSYSLIST is described in J7C. 



jy 
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Pos. Opnd 



e 



Specifications 



The positional operands of a macro 
instruction must be specified in 
the same order as the positional 
parameters declared in the called 
macro definit ion . 



^Ty 



Source Module 









A 




MACRO 






CP 














ORDER 




&P1 


,&P2, 


&P3 


DC 


C 


&P1' 






DC 


C 


&P2' 






DC 


C 


&P3* 







MEND 



OPEN START 



ORDER 



AfB f C , 




DC 
DC 
DC 



C'A" 
C'B' 
C'C 



END 



Each positional operand constitutes 
a character string. It is this 
character string that is the value 
passed through a positional parameter 
into a macro definition. 



^^r 



Examples of Macro Instructions: 
MACCALL VALUE ,9,8 

r 

MACCALL SA^iOtfOTED STRING* 



MACCALL 



1XPIW-2 ,, SYMBOL 
_1 



Omitted operand 
has null character 
value 



MACCALL |A # B,C,D.#£) ,{1,2,3,4) 



Each positional 
operand can be 
up to 255 
characters long 



Sublists 
described in 
L4 
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The figure to the right illustrates 
what happens when the number of 
positional operands in the macro 
instruction differs from the number 
of positional parameters declared 
in the prototype statement of the 
called macro definition. 



Number of 
positional ■ 
parameters 
in Prototype 
of macro 
definition 


Number of Positional 
Operands in macro 
instruction 


EQUAL 


GREATER 
THAN 


LESS 
THAN 


Valid, if 
Operands 
are correctly 
specified 




- 




Meaningless, 
unless &SYSLIST 
is specified in 
definition to 
refer to excess 
operands 








f 


Omitted operands 
give null character 
values to correspond- 
ing parameters (or 
&SYSLIST specifi- 
cation) 



K3B -- KEYWORD OPERANDS 



Purpose 



You can use a keyword operand to pass a value through a 
keyword parameter into a macro definition. The values 
you specify in keyword operands override the default values 
assigned to the keyword parameters. The default value 
should be a value you use frequently. Thus, you avoid 
having to write this value every time you code the calling 
macro instruction. 



w 



When you need to change the default value, you must use 
the corresponding keyword operand in the macro instruction. 
The keyword can indicate the purpose for which the passed 
value is used. 



\ja, 



jf* 
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Specifications 



Any keyword operand specified in 
a macro instruction must correspond 
to a keyword parameter in the macro 
definition called. However, keyword 
operands do not have to be specified 
in any particular order. 



Key Opnd 



o 



A keyword operand must be coded 
in the format shown in the figure 
to the right. If a keyword operand 
is specified, its value overrides 
the default value specified for 
I the keyword parameter. 

The standard default value obeys 

the same rules as the value specified 

in the keyword operand (see K5) . 



KEYWORD =VALUE 



Keyword 
Operand 



Identifying 

"Keyword" 

symbol has 

up to 7 

charcters 

without 

ampersand 



Value can be 
up to 255 
characters long 



© 




=DEFAULT 



Examples of Keyword Operands ■■ 
MACKEY KE YW0RD= |& # B , C , D , E )' 



Corresponding 

Keyword 

Parameter 



Sublist 
described 
in K4 



MACKEY KEYl=l,KEY2=2,KEY3=3 

MACKEY KEY3=2000 ,KEY1=0 , KEYWORD=HALLO 



Section K: The Macro Instruction 297 



The following examples describe 
the relationship between keyword 
operands and keyword parameters 
and the values that the assembler 
assigns to these parameters under 
different conditions. 



i The keyword of the operand 
corresponds to a keyword parameter . 
The value in the operand overrides 
the default value of the parameter. 

I The keyword operand is not specified 
The default value of the parameter 
is used. 

.The keyword of the operand does 
' not correspond to any keyword 
parameter. The assembler issues 
an error message, but the macro 
is generated using the default 
values of the- other parameters. 

NOTE: The default value specified 
for a keyword parameter can be the 
I null character string. The null 
character string is a character 
string with a length of zero; it 
is not a blank, because a blank 
occupies one character position. 



Source Module 



Null character 
string is default 
value 



MACRO 



MACCORR &KEYl=DEFAULT,&KEY2=, &KEY3=123 



SHOW DC C&KEY1&KEY2&KEY3 1 



MEND 



OPEN START 



MACCORR KEYl=OVERRIDE,KEY2=0,KEY3=456 




MACCORR KEY4=SYMBOL,KEY2=0 **ERROR* : 




MACCORR KEY1=,KEY3=456 
Null J 





SHOW DC C456 



END 



> 



^Ly' 
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K3C — COMBINING POSITIONAL AND KEYWORD OPERANDS 
Purpose 



You can use positional and keyword operands in the saire 

macro instruction: use a positional operand for a value 

that you change often and a keyword operand for a value 
that you change infrequently. 



e 



Spec i fications 



Positional and keyword operands 
can be mixed in the macro instruction 
operand field. However, the 
positional operands must be in the 
same order as the corresponding 
positional parameters in the macro 
prototype statement. 



006 All positional operands must precede 
operands, if specified. 



MACRO 




1 


2 


3 4 5 


MIXED 


&P1 


r&P2, 


&P3 , &P4 , &P5 , &KEY1=10 , &KEY2=A 

© 


MEND 


START 
MIXED 
END 




A" 

1 


2 


KE¥1 


=20,C,KEY2=SR,D,E 
3 4 5 



MACRO 



REFER &P1 , &P2 , &KEY1=AREA1 , &KEY2=DAY 

": O 



&KEY1 DC 



MEND 



START 



END 




REFER ;£0 < KEY1=AREA2 ,F , L5 , KEY2=M0NTH ,*24524 ' A 




AREA2 DC 10FL5'2024' 



NOTE: The system variable symbol 
6SYSLIST (n) refers only to the 
positional operands in a macro 
instruction. 

I&l'-;t.%yif0r& operands mast follow A 
*&r iKWitJLomtfl operands specified. 
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K4 - Sublists in Operands 






Purpose 

You can use a sublist in a positional 
or keyword operand to specify several 
values. A sublist is one or more 
entries separated by commas and 
enclosed in parentheses. Each entry 
is a value to which you can refer 
in a macro definition by coding: 

1. The corresponding symbolic 
parameter with an appropriate 
subscript or 

2. The system variable symbol 
&SYSLIST with appropriate subscripts, 
the first to refer to the positional 
operand and the second to refer 

to the sublist entry in the operand. 

&SYSLIST can refer only to sublists 
in positional operands. 



Specifications 

The value specified in a positional 
or keyword operand can be a sublist, 

A symbolic parameter can refer to 
the entire sublist or to an 
individual entry of the sublist. 
To refer to an individual entry, 
the symbolic parameter must have 
a subscript whose value indicates 
the position of the entry in the 
sublist. The subscript must have 
a value greater than or equal to 
one. 



Source Module 



MACRO 




SUBLISTS &Pl,&P2 ,&KEY=(F0 ,F ,0) 



&KEY(1) DC &KEY(2) '&KEY(3) ' 
&P1{1) DC &P1(2) '&P1(3)' 

o 



DC A&P2 



Refers to 
value in 
positional 
operand 



% 



Refers to 
default 
value in 
keyword 
operand 



MEND-, 



OPEN 



START 




SUBLISTS (H20,H,200) , (A,B,C) 




H^ 



FO 


DC 


F'O' 


H20 


DC 


H'200' 




DC 


A(A,B,C) 



END 
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The format of a sublist is given 
in the figure to the right. A 
sublist, including the enclosing 
parentheses, must not contain more 
than 255 characters. 











Format: 

k 
Examples: £ 


One or more entries 
separated by commas 
and enclosed in 
parentheses 




K,htC,t> t E) 








Valid sublist with the 
null character string 
as the only entry 













/#■> 






The figure to the right shows the 
relationship between subscripted 
parameters and sublist entries if: 

■■ A sublist entry is omitted, 

OThe subscript refers past the end 
of the sublist, 

OThe value of the operand is not 
a sublist, 

^^The parameter is not subscripted. 

NOTE: The system variable symbol, 
6SYSLIST(n,m) , can also refer to 
sublist entries, but only if the 
sublist is specified in a positional 
operand . 



Parameter 



&PAROI 



&PAR ( 5 ) 



&PAR 

&PARQ) 

&PAR(2) 



&PAR 

&PAR(1) 

&PAR(2) 

&PAR 
&PAR(1) 
&PAR ( 3 ) 



&PAR(2) 



&PAR(1) 



Sublist specified 
in corresponding 
operand (or as 
default value of 
keyword parameter) 



©(1,2, ,4) 



©d,2,3 f 4) 



it 



e 



&P0SPAR(3) 
&SYSLIST(2,3) 



(AP 

(A) 

(A) 







Considered as 
Sublists 



(Ay ,C,D) 



This blank indicates 
end of operand field 



(*) 



Positional Operands 
A, (1,2,3,4) 

A, (1,2,3,4) 



Value generated 
(or used in 
computation) 



Null character string 



Null character string 



A 

A 
Null character string 



(A) 
A 
Null character string 


Null character string 
Null character string 



Nothing 



"ERROR* 
Unmatched left 
parentheses 



Nothing 
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K5 - Values in Operands 

Purpose 

You can use a macro instruction operand to pass a value 
into the called macro definition. The two types of value 
you can pass are: 

1. Explicit values or the actual character strings you 
specify in the operand. 

2. Implicit values, or the attributes inherent in the data 
represented by the explicit values. 

Attributes are fully described in L1B. 

Specifications 

The explicit value specified in a macro instruction operand 
is a character string that can contain one or more variable 
symbols . / 

The character string must not be 
greater than 255 characters after 
substitution of values for any 
variable symbols. This includes 
a character string that constitutes 
a sublist (see K4) . 

The character string values, including sublist entries, 
in the operands are assigned to the corresponding parameters 
declared in the prototype statement of the called macro 
definition. A sublist entry is assigned to the 
corresponding subscripted parameter. 



302 






© 



OMITTED OPERANDS: When a keyword 
operand is omitted, the default 
value specified for the corresponding 
keyword parameter is the value 
^^ assigned to the parameter. When 
^P a positional operand or sublist 

entry is omitted, the null character 
string is assigned to the parameter. 

NOTE: Blanks appearing between 
commas do not signify an omitted 
positional operand or an omitted 
sublist entry. 



O 



SPECIAL CHARACTERS: Any of the 
256 characters of the System/370 
character set can appear in the 
value of a macro instruction operand 
(or sublist entry) . However, the 
following characters require special 
consideration : 

AMPERSANDS : A single ampersand 
indicates the presence of a variable 
symbol. The assembler substitutes 
the value of the variable symbol 
into the character string specified 
in a macro instruction operand. 
The resultant string is then the 
value passed into the macro 
definition. If the variable symbol 
is undefined, an error message is 
issued. 

Double ampersands must be specified 
if they are to bo passed tc the 
macro definition. 



Source Module 



MACRO 



OMIT &P1,&P2,&P3,&KEY1=DC , &KEY2=C 



&KEY1 &P1&KEY2&P2' ALWAYS &P3 1 



MEND 



OPEN START 

OMIT J , r HERE 







Commas indicate 
omission of first 
two positional 



two positional |&P3=HERe1 
operands / 

rNuinft rNuin / 

p^r"'« at. wave tif nv • 



DC C" ALWAYS HERE 



1/1 This bl 
y lend of 



blank indicates 
operand field 



OMIT , r ,HERE 




&P3 considered 
omitted, 
value -null 



DC C ALWAYS ' 



OMIT lOfLlO'*- 




Last positional 
operand omitted, 
no comma needed 



&P3=null 



DC 10CL10' ALWAYS H 



END 



Value 


Value Of 


Character 


Specified 


Variable 


String 


In Operand 


Symbols Ajk 


Value £fc 
Passed ^F 


&VAR 


XYZ 


XYZ 


&A+&B+3+&C*10 


&A=2 
&B=X 
&C=COUNT 


2+X+3+COUNT*10 


'^MESSAGE' 




BLANK BETWEEN 


'BLANK BETWEEN' 




Quoted string 






described below 




- 




■registr 




&&REGISTER 


NOTE|§j§| 


. 


NOTE&&&& 



Section K: The Macro Instruction 303 



PageofGC33-4010-4 
Revised April 29, 1977 
By TNL: GN33-8226 



APOSTROPHES: A single apostrophe is used: (1) to indicate 
the beginning and end of a quoted string, and (2) in a 
length attribute notation that is not within a quoted 
string. 

QUOTED STRINGS: A quoted string is any sequence of 
characters that begins and ends with a single apostrophe 
(compare with conditional assembly character expressions 
described in L4B) . Double apostrophes must be specified 
inside each quoted string. This includes substituted 
apostrophes. 

Macro instruction operands can have values that include 
one or more quoted strings. Each quoted string can be 
separated from the following quoted string by one or more 
characters , and each must contain an even number of 
apostrophes . 







'QUOTED STRING' 



Value specified 
in Operand 



'&&NOTATION' 
' &MESSAGE ' 



' L ' ' SYMBOL ' 

• L ' ' &VAR ' 
'& QUOTES' 



L ' SYMBOL • 



Indicates end 
of quoted string 



Indicates beginning 
of a new quoted 
string 



Value of 
Variable 
Symbol 



BLANKS OK 



SYMBOL 



' QUOTE 1 ' m& ' QUOTE 2 ' 

o 



No apostrophes, single ampersands, 
commas, blanks, or equal signs 
allowed between quoted strings in 
one operand 



?AB' 'CD f .E'FGH&&,' 



\ 



Quoted strings 



Value Passed 



•&&NOTATION 1 
'BLANKS OK' 



L ' ' SYMBOL ' 




INVALID 
OPERAND 
IVALUE 



' QU0TE1 * AND ' QU0TE2 



'AB' , CD , E , FGH&& , 



^* ! 



\jP 
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LENGTH ATTRIBUTE NOTATION: In macro 
instruction operand values, the 
length attribute notation with 
ordinary symbols can be used outside 
of quoted strings, if the length 
attribute notation is preceded by 
any special character except the 
ampersand. 





Does not initiate 
or end a quoted 
string 




K19 
OUTERCAL L 1 


SYMBOL , 1 0+L * AREA*L ' FIELD 



c 



PARENTHESES: In macro instruction 
operand values, there must be an 
equal number of left and right 
parentheses. They must be paired, 
that is , to each left parenthesis 
belongs a following right parenthesis 
at the same level of nesting. An 
unpaired (single) left or right 
parenthesis can appear only in a 
quoted string. 



r 



t 



(PAIRED PARENTHESES) 



Examples: 



These parentheses 
could be enclosing 
a sublist 



Null 



(A,B,C,D,E) , (A, (B) ,C,D; 



) UNPAIRED PARENTHESES ( 



Invalid 

operand 

value 



(a(b)c)d(e) 

I I 

Level 1 



Level 2 Level 2 



Paired 



(IN 1 ( 'STRING) 

( THESE • ( ' ARE ' ) • UNPAIRED ) 



Paired 
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BLANKS: One or more blanks outside 
a quoted string indicates the end 
of the entire operand field of 
a macro instruction. Thus blanks 
should only be used inside quoted 
strings. 



COMMAS; A comma outside a quoted 
string indicates the end of an 
operand value or sublist entry. 
Commas that do not delimit values 
can appear inside quoted strings 
or paired parentheses that do not 
enclose sublists. 



EQUAL SIGNS; An equal sign can 
appear in the value of a macro 
instruction operand or sublist 
entry; 

As the first character , 

Inside quoted strings , 

Between paired parentheses, or 

' In a positional parameter , 
provided that the parameter does 
not resemble a keyword parameter 



mSm, 



Examples of Macro Instructions: 



MACCALL ' BLANKS T ALLOWED ' , OR , 
MACCALL EXPR+.3.-B*100,C-D/E 



No blanks between 
terms and operators 



Considered as remarks 



MACCALL AREA1,AREA2, MESSAGE N03 

T 



Unpaired left 
parenthesis 



7 



End of 
operand field 



Remarks 



MACCALL (A,B,C, ,D,B) 

MACCALL (A, (B,C,D) f E, (F f ,G) ,H) 



Unpaired left 
parenthesis 



MACCALL 'A' OR 'B* 
MACCALL A+B-C*D+ E 



Remarks 



Examples of Macro Instructions: 

MACCALL A,B,C,D 

MACCALL (A,B,C,D) 



MACCALL 'IN CASE 1, MESSAGE N03 IS ISSUED' 

t 

© 

paired / 

(1,2)'3'5,V 



MACCALL C 



1 



Also part of character 
string if parentheses 
do not enclose sublist 



Examples of Macro Instructions: 



Could be literal specifications 



MACCALL KEYyF^Ol', (=IT201 ' , =^[ ' 202 ' ,=H» 3 ') 

© 



Character string 




MACCALL A'= I B / C(A=B) 

© © 

MACCALL (A(B=1) ,C,D,E) 



MACCALL 2X=B 

© 



2X is not a valid keyword 



G 
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PERIODS ; A period (.) can be used 
in the value of an operand or sublist 
entry. It will be passed as a period. 
However, if it is used immediately 
after a variable symbol it becomes 
a concatenation character. Then, 
two periods are required if one 
is to be passed as a character. 



Character String 
specified as value 
of Operand or 
Sublist Entry 


Value of 
Variable 
Symbol 


Value 
Passed 


3.4 
(3.4,3.5,3.6) 




3.4 
3.4 3.5 3.6 


&aFi 

& A.l ^ 


FIELD 

3 

3 
&A=AREA ) 
&B=200 J 


FIELD1 

f 1 A 


&a!.i V 

&A&B ^^ 


3!l 1* 

AREA200 
AREA200 


&a!&b ^^ 


&DISP. (&BASE) 


&DISP=1000 
&BASE=10 


1000(10) 



K6 - Nesting in Macro Definitions 



K6A — PURPOSE 



A nested macro instruction is a 
macro instruction that you specify 
as one of the statements in the 
body of a macro definition.. This 
allows you to call for the expansion 
of a macro definition' from within 
another macro definition. 



Inner and Outer Macro Instructions 



Any macro instruction you write 
in the open code of a source module 
is an outer macro instruction or 
call. Any macro instruction that 
appears within a macro definition 
is an inner macro instruction or 
call. 



Source Module 



MACRO 



OUTER 



e 



MEND 
MACRO 



INNER 



MEND 



OPEN START 



END 



These are prototype 
statements 
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Levels of Nesting 



The code generated by a macro definition called by an inner 
macro call is nested inside the code generated by the macro 
definition that contains the inner macro call. In the 
macro definition called by an inner macro call, you can 
include a macro call to another macro definition. Thus, 
you can nest macro calls at different levels. 

The zero level includes outer macro calls, calls that 
appear in open code; the first level of nesting includes 
inner macro calls that appear inside macro definitions 
called from the zero level; the second level of nesting 
includes inner macro calls inside macro definitions that 
are called from the first level, etc. 
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Source Module 

LEVEL 



START 



OUTER 



END 



Macro Definitions 

MACRO MACRO 



MACRO 



OUTER 



INNER1 



MEND 



LEVEL 1 



INNER1 




: . 




INNER 2 




V 


MEND 





INNER2 



MEND 



LEVEL 2 




LEVEL 3 
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Recursion 



You can also call a macro definition 
recursively, that is, you can write 
macro instructions inside macro 
definitions that are calls to the 
containing definition . This allows 
you to define macros to process 
recursive functions. 



Source Module 




MACRO 



RECURSE 



prototype statement 



RECURSE 




MEND 



OPEN START 



RECURSE 



Test here to 
escape from 
recursive loop 



macro instruction 



On 




END 



V_*-' 
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K6B ~ SPECIFICATIONS 



General Rules and Restrictions 



Nesting 






Macro instruction statements can 
be written inside macro definitions. 
Values are substituted in the same 
way as they are for the model 
statements of the containing macro 
definition. The assembler processes 
the called macro definition, passing 
to it the operand values (after 
substitution) from the inner macro 
instruction. In addition to the 
operand values described in K5 
above, nested macro calls can specify 
values that include: 

^p Any of the symbolic parameters 

specified in the prototype statement 
of the containing macro definition 

^P Any SET symbols declared in the 
containxng macro definition 

^^ Any of the system variable symbols 



The number of nesting levels 
permitted depends on the complexity 
and size of the macros at the 
different levels, that is: the 
number of operands specified, the 
number of local and global SET 
symbols declared (see L1A) and the 
number of sequence symbols used. 



Macro Definitions 



These are parameters 



Prototype 



Inner call 




MACRO 

OUTER &?I , &P2 , &KEY1=VALUE 



LCLC &C 



* 



&C SET 'ABC 



These are operands 




INNER &P1,&KEYI,&C 

e 




Inner call 



MEND 



Exits taken from the different 
levels of nesting when a MEXIT or 
MEND instruction is encountered 
are as follows: 

1. From the expansion of a macro 
definition called by an inner macro 
call, an exit is taken to the next 
sequential instruction that appears 
after the inner macro call in the 
containing macro definition. 

2. From the expansion of a macro 
definition called by an outer macro, 
an exit is taken to the next 
sequential instruction that appears 

I after the outer macro call in the 
open code of a source module. 



Source Module 
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Passing Values through Nesting 
levels 



The value contained in an outer 
macro instruction operand can te 
passed through one cr rrcre levels 
of nesting. However, the value 
specified in the inner rracrc 
instruction operand must fce identical 
to the corresponding symbolic 
parameter declared in the prototype 
of the containing iracrc definition. 

Thus, a sublist can he passed and 
referred to as a sublist in the 
macro definition called by the inner 
macro call. Also, any symbol that 
is passed will carry its inherent 
attribute values through the nesting 
levels. 

Values can be passed from open code 
through several levels cf macro 
nesting if inner macro calls at 
each level are specified with 
symbolic parameters as operand 
values. 



Source Module 



Prototype 



Call 



Prototype 



Call 



MACRO 



outer *pl,*s£,t£l 



INNER $£|,&ga,&gf 1 



MEND 
MACRO 



INNER &Q,&R,&S 



L 
A 
ST 



MVC 



3,&Q(Dl 

3,&Q(2)\A 

3,&Q(3)|^ 



&R,&S 



MEND 



START 



Passed Values 



outer (&mk,T2M!mMhm, 





hmmmmm»-mmmmm?-~imitmim 



INNER m,ij$/*ffj( 

&Q &R &S 




L 3, AREA 
A 3,F200 
ST 3, SUM 



MVC TO, FROM 



END 



/A 



/On 



^ 
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NOTE: If a 
only a part 



symbolic parameter is 
of the value specified 



in an inner 
operand, onl 
value given 
an outer cal 
the nesting 
entries and 
are net avai 
in the inner 



iracrc instruction 
v tne character string 
tc the parameter by 
1 is passed through 
level. Inner sublist j ^ 
attributes of symbols ^ p 
lable fcr reference 
macro . 
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System Variable Symbols in Nested 
Macros 



The global read-only system variable 
OS symbols: SSYSPARM, IffflfiiflK? and 
only SSYS are not affected by the 
nesting of macros. The remaining 
system variable symbols are given 
local read-only values that depend 
on the position of a macro 
instruction in code and the operand 
value specified in the macro 
instruction. 



If 6SYSLIST is specified in a macro 
definition called by an inner macro 
instruction, then SSYSLIST refers 
to the positional operands of the 
inner macro instruction. 



Source Module 



Prototype 



Call 



Prototype 



Call 



Prototype 



Call 



MACRO 



OUT 



INI A,B,C 



MEND 
MACRO 




INI 

DC A(&SYSLIST(2) ) 



IN2 D,E,F 



MEND 
MACRO 



IN2 



DC Y(&SYSLIST(3) ) 



MEND 



START 



OUT 



Ajy 
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The assembler increments SSYSNDX by one each time it 
encounters a macro call. It retains the incremented value 
throughout the expansion of the macro definition that is 
called, that is, within the local scope of the nesting 
level. 



Macro Definitions 



Source 
Module 



MACRO 




MACRO 




MACRO 


OUTER 




INNER1 


* 


INNER2 


INNER1 


INNER2 




MEND 






MEND 



LEVEL LEVEL 1 



MEND 



LEVEL 2 



LEVEL 3 
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OThe assembler gives SSYSECT the character string value 
of the name of the control section in force at the point 
^m where a macro call is made. For a macro definition called 
by an inner macro call , the assembler will assign SSYSECl ^p 
the name of the control section generated in the macrc ^^ 
definition that contains the inner macro call. The control 

O section must be generated before the inner macro call is 
processed. 

If no control section is generated within a macro 

©definition, the value assigned to SSYSECT does not change. 
It is the same for the next level of macro definition 
called by an inner macro instruction. ^^ 

£h SSYSECT has a local scope; its read-only value remains 
^^ constant throughout the expansion of the called macro 
definition. 



^Ly 



Source Module 



MACRO 



Macro Definitions 

MACRO 



MACRO 



OUTER 



B CSECT 

DC A(&SYSECT) 



INNERl 



©^ 



/' 



/ 



INNER1 

DC A(&SYSECT] 

INNER2 



INNER2 



DC A(&SYSECT) 



LEVEL 



MEND 
LEVEL1 



MEND 



LEVEL2 



MEND 



LEVEL 3 



\^j/ 



A START 
OUTERjA 



&sysect=a] 




&SYSECT=B 



END 



G 
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This section describes the conditional assembly language. 
With the conditional assembly language, you can perforir 
general arithmetic and logical computations as well as 
many of the other functions you can perform with any ether 
programming language. In addition, by writing conditional 
assembly instructions in combination with other assembler 
language statements you can: 

1. Select sequences of these source statements, called 
model statements, from which machine and assembler 
instructions are generated 

2. Vary the contents of these model statements during 
generation 

The assembler processes the instructions and expressions 
of the conditional assembly language at pre-assembly time. 
Then, at assembly time, it processes the generated 
instructions. Conditional assembly instructions, however, 
are not processed after pre-assembly time. 

The conditional assembly language is more versatile when 
used to interact with symbolic parameters and the system 
variable symbols inside a macro definition. However, you 
can also use the conditional assembly language in open 
code as described in L7 below. 



LI - Elements and Functions 

The elements of the conditional assembly language are 

1. SET symbols that represent data (see L1A) 

2. Attributes that represent different characteristics 
of data (see L1B) 

3. Sequence symbols that act as labels for branching to 
statements at pre-assembly time (see L1C) . 

The functions of the conditional assembly language are: 



Section L: The Conditional Assembly Language 317 



1. Declaring SET symbols as variables for use by the /<r > N 
conditional assembly language in its computations (see Q J 

L2) ^~ 

2. Assigning values to the declared SET symbols (see L3) 

3. Evaluating conditional assembly expressions used as 
values for substitution, as subscripts for variable symbols, 
or as condition tests for branch instructions (see L4) 

4. Selecting characters from strings for substitution in 
and concatenation to other strings, or for inspection in 
condition tests (see L5) 

5. Branching and exiting from conditional assembly loops 
(see 16) . 

L1A - SET SYMBOLS 
Purpose 



SET symbols are variable symbols that provide you with 
arithmetic, binary, or character data, whose values you 
can vary at pre-assembly time. 

You can use SET symbols as: 

1. Terms in conditional assembly expressions 

2. Counters, switches, and character strings 

3. Subscripts for variable symbols 

4. Values for substitution. 

Thus, SET symbols allow you to control your conditional 
assembly logic and to generate many different statements 
from the same model statement. 

SUBSCRIPTED SET SYMBOLS ; You can use a SET symbol to 
represent an array of many values. You can then refer 
to any one of the values of this array by subscripting 
the SET symbol. 



\^y 
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The Scope of SET Symbols 

You must declare a SET symbol before 
you can use it. The scope of a 
SET symbol is that part of a program 
for which the SET symbol has been 
declared. 

If you declare a SET symbol to have 
a local scope, you can use it only 
in the statements that are part 
of: 

• The same macro definition or 

, • Open code. 

If you declare a SET symbol to have 
a global scope, you can use it in 
the statements that are part of: 

• The same macro definition, and 

• A different macro definition, 
and 

• Open code. 



You must, however, declare the SET 
^^ symbol as global for each part of 
^P the program (a macro definition 

or open code) in which you use it. 

You can change the value assigned 
to a SET symbol without affecting 
the scope of this symbol. 

THE SCOPE OF OTHER VARIABLE SYMBOLS: 
A symbolic parameter has a local 
scope. You can use it only in the 
statements that are part of the 
macro definition for which the 
parameter is declared. You declare 
a symbolic parameter in the prototype 
statement of a macro definition. 

The system variable symbols, 
6SYSLIST, SSYSECT, and SSYSNDX have 
a local scope; you can use them 
only inside macro definitions. 
©S However, the system variable symbols, 
only 6SYSPARM, SSYSDATE* *»<? fSYjTIHE 
"have a global scope; you can use 
them in both open code and inside 
any macro definition. 



Source Module 



L 

o 





START 



G 



Macro Definitions 
Called 



xz 
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Specifications 



SET symbols can be used in model 
statements from which assembler 
language statements are generated, 
and in conditional assembly 
instructions. The three types of 
SET symbols ares SETA, SETE, and 
SETC. A SET symbol must be a valid 
variable symbol, as shown in the 
figure to the right. 

A SET symbol must be declared before 
it can be used. The instruction 
that declares a SET symbol determines 
its scope and type (see L2) . 





SET Symbols 

. ampersand 
// alphabetic character 
///\ to 6 alphameric characters 


Format: 


\ \ 1 1 1 

& . S E T S ' 


Sf M B 1 






Declaration: 






Instruction WfM 


Type 


Scope 


Operation 


Operand 


LCLA 
LCLB 
LCLC 

GBLA 
GBLB 
GBLC 


&ARITH 
& BOOLEAN 
&CHAR 

&A 
&B 
&C 


SETA 
SETB 
SETC 

SETA 
SETB 
SETC 


local 
local 
local 

global 
global 
global 



L'; .J 



V>/' 



The features of SET symbols and 
other types of variable symbol are 
compared in the figure to the right. 

The value assigned to a SET symbol 
can be changed by using the SETA, 
SETB, or SETC instruction within 
the declared scope of the SET symbol. 
However, a symbolic parameter and 
the system variable symbols are 
assigned values that remain fixed 
throughout their scope. Wherever 
a SET symbol appears in a statement, 
the assembler replaces the symbol 
with the last value assigned to 
the symbol. 



Feature 


Types of Variable Symbol 


SETA, SETB, 
or SETC 
Symbols 


Symbolic 
Parameters 


System 

Variable 

Symbols 


Can be used • 
In open code 

In macro 
definitions 


YES 


NO 


only: &SYSPARM 
06 &SYSDATE 


YES 


YES 


All 


Scope: 
Local or 

* 

Global 


YES 


YES 


&SYSLIST 

&SYSECT 

&SYSNDX 


YES 


NO 


&SYSPARM 
-»* &S YS&ATfg ■ -'^ 


Values can 
be changed 
within scope 
of symbol 


o 

YES 


e 

NO: 

read only 

value 


e 

NO: 

read only 
value 



c 
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ONOTE: . SET symbols can be used in dfr 
^ e name an< 3 operand field of macr&* 
instructions. However, the value 
thus passed through a symbolic 
parameter into a macro definition 

Ois considered as a character string 
and is generated as such. 

§|Kpi 7 Y!££c $**r»ll*ro* instruction 

^^»^;.'^f#c«d* the Sfiatf instruction. > 








Source Module 








NAME 


START 
LCLC 




&LIST,&LABEL 

IH' ' ' . : \ 






&LIST 


SETC 


•■(x,Y,zr 






|& LABEL 


SETC 


1 STRING » 






o 


# 


e 






J&LABEL 


MACCALL 


&LIST V , 




Macro 
Instruction 






© 


^4 


o 






Vv.'-- MACRO 


M- 




&N MACCALL 


&p 








• 




Macro 




END \ 


&N DC 


AMP 

\ 


Definition 
Called 








MEND 




\ 












Can only refer 






X 








to whole string 


STRING DC A(X, 


Y,Z) 


Generated 






"V- 


^ result 
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Subscripted SET Symbols - 
Specifications 



A subscripted SET symbol must be 
specified as shown in the figure 
to the right. 

The subscript can be any arithmetic 
expression allowed in the operand 
field of a SETA instruction (see 
L4A) . 

A subscripted SET symbol can be 
used anywhere an unsubscripted SET 
symbol is allowed. However, 
subscripted SET symbols must be 
declared as subscripted by a previous 
local or global declaration 
instruction. 

O Tne supscr ^P^ refers to one of the 
m± many positions in an array of values 
%J identified by the SET symbol. The 
^^ value of the subscript must not 
^P exceed the dimension declared for 
the array in the corresponding LCLA, 
LCLB, LCLC, GBLA, GBLE, or GBLC 
instruction. 

NOTE: The subscript can be a 
J fr subscripted SET symbol. Five levels 
^^ of subscript nesting are allowed. 



Format 



& SETS YM ( l«JJM«fat| ) 



Variable 
symbol 



Arithmetic Expression 
whose value must not 
beOor negative 



Example LCLA &ARRAY (20) 

e 



ARRAY 



&ARRAY(10) = 5 




12 3 4 5 6 7 8 91011 12 

I 



Equivalent ' 




S 



, &ARRAY ( &ARRAY ( 10 ) ) =2 
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L1B - DATA ATTRIBUTES 

What Attributes Are 



The data, such as instructions, constants, and areas, which 
you define in a source module can be described in terirs 
of: 

1. Type, which distinguishes one form of data froir another: 
for example, fixed-point constants from floating-point 
constants, or machine instructions from macro instructions. 

2. Length, which gives the number of bytes occupied by 
the object code of the data. 

3. Scaling, which indicates the number of positions occupied 
by the fractional portion of fixed-point and decimal 
constants in their object code form. 

4. Integer, which indicates the number of positions occupied 
by the integer portion of fixed-point and decimal constants 
in their object code form. 

5. Count, which gives the number of characters that wculd 
be required to represent the data, such as a macro 
instruction operand, as a character string. 

6. Number, which gives the number of sublist entries in 
a macro instruction operand. 

These six characteristics are called the attributes of 
the data. The assembler assigns attribute values to the 
ordinary symbols and variable symbols that represent the 
data. 
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Purpose 



Specifying attributes in conditional 
assembly instructions allows you 
to control conditional assembly 
logic, which in turn can control 
the sequence and contents of the 
statements generated from model 
statements. The specific purpose 
for which you use an attribute 
depends on the kind of attribute 
being considered. The attributes 
and their main uses are shown in 
the figure to the right. 

NOTE: The number attribute of 
6SYSLIST (m) and SSYSLIST (m,n) is 
described in J7C. 



Attribute 


Purpose 


Main Uses 


Type 


Gives a letter that 
identifies type of 
data represented 


- In tests to distinguish 
between different data 
types 

- For value substitution 

- In macros to discover 
missing operands 


Length 


Gives number of 
bytes that data 
occupies in storage 


- For substitution into 
length fields 

- For computation of 
storage requirements 


Scaling 


Refers to the 
position of the 
decimal point in 
decimal, fixed-point 
and floating-point 
constants 


- For testing and regulating 
the position of decimal 
points 

- For substitution into a 
scale modifier 


Integer 


Is a function of 
the length and 
scaling attributes 
of decimal, fixed- 
point, and floating- 
point constants 


- To keep track of 
significant digits (integers) 


Count 


Gives the number 
of characters 
required to repre- 
sent data 


- For scanning and 
decomposing of 
character strings 

- As indexes in sub- 
string notation 


Number 

o 


Gives the number 
of sublist entries 
in a macro 
instruction operand 
sublist 


- For scanning sublists 

- As counter to test for 
end of sublist 






Specifications 



FORMAT: The format for an attribute 
reference is shown in the figure 
to the right. 

'The attribute notation indicates 
the attribute whose value is desired. 

(The ordinary or variable symbol 
represents the data which possesses 
the attribute. The assembler 
substitutes the value of the 
attribute for the attribute 

1 r efeirence. 

WHERE ALLOWED: An attribute 
reference to the type, scaling, 
integer, count, and number attributes 
can be used only in a conditional 
assembly instruction. The length 
attribute reference can be used 
both in a conditional assembly 
instruction and in a machine or 
assembler instruction (for details 
on this use see CUC) . 



V 



uti 







Attributes 




Apostrophe 

/ 

i 


Format: 


Attribute | 
Notation tf] 


> 


Ordinary or 

Variable 

Symbol 


e 












Examples: 


ga± Attribute Reference 

T ' SYMBOL 
L ' &VAR 
K'&PARAM 





.c 



y 
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COMBINATION WITH SYMBOLS; The figure below shows the six 
kinds of attributes and the type of symbol with which the 
attributes can be combined. 



NOTE: Whether or not an attribute reference is allowed 
in open code, in macro definitions, or in both, depends 
on the type of symbol specified. 





Symbols 
Specified 


ATTRIBUTES SPECIFIED 




Type 
T' 


Length 
L' 


Scaling 
S' 


Integer 

r 


Count 
K' 


Number 
N' 






r 

* 
r 


Ordinary Symbols 


YES 


YES 


YES 


YES 


YES 


YES 










SET Symbols 


YES 


NO 


NO 


NO 


YES 


NO 






IN OPEN CODE 


< 










System Variable Symbols: 
&SYSPABM, &SYSDATE , 
&SYSTIME 


YES 


NO 


NO 


NO 


YES 


NO 






Ordinary Symbols 


YES 


YES 


YES 


YES 


NO 


NO 




SET Symbols 


YES 


NO 


NO 


NO 


YES 


NO 








Symbolic Parameters 


YES 


YES 


YES 


YES 


YES 


YES 


IN MACRO DEFINITIONS 


\ 


System Variable Symbols. 
&SYSLIST 


YES 


YES 


YES 


YES 


YES 


YES 












&SYSNDX,&SYSPARM, 
&SYSDATE, &SYSECT, 
&SYSTIME 


YES 


NO 


NO 


NO 


YES 


NO 










.■>>j. - ' . ■' ^P*"*?*^* j» WyfWffWf* , '"*■'■'■■"''., 


YES 


YES 


YES 


YES 


NO 


NO 




;;*.v-V :.... •":.•■■ 1 




< 




$>"'■■■ ■' ' 






^ ?••'•" 


; Ordinary Symbols " 


NO 


YES 


NO 


NO 


NO 


NO 




fc • " . " 


i" faRtotffef&H&l&B*. 


YES 


YES 


YES 


YES 


YES 


YES 




IN IKACfiO DEFINITIONS 


■* 




System Variable 


YES 


YES 


YES 


YES 


YES 


YES 




: 
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ORIGIN OF VALUES; The value of 
an attribute for an ordinary symbol 
specified in an attribute reference 
comes from the data represented 
by the symbol , as shown in the 
figure to the right. 

The symbol must appear in the name 
field of an assembler or machine 
instruction, or in the operand field 
of an EXTRN or WXTRN instruction. 
The instruction in which the symbol 
is specified: 

1. Must appear in open code 

2. Must not contain any variable 
symbols , and 

3. Must not be a generated 
instruction. 



.4~\ 



Attribute 
Notation 



Ordinary 
Symbol 



Statement 
Label 



Operand 
of 

EXTRN or 
WXTRN 
Instruction 



T' 
L' 
S' 
l' 



\i__y 
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Olhe value of an attrioute for a 
variable symbol specified in «*n 
attribute reference comes from the 
value substituted for the variable 
symbol as follows (see also the 
figure to the right) : 

05 1 . For SET symbols and the system 
on'v variable symbols &SYSECT, SSYSNDX, 
SSYSPABM, £SYSDATE r and &SYSTIME, 

Othe attribute values come from the 
current data value of these symbols. 

2. For symbolic parameters and the 
system variable symbol, SSYSLIST, 
the values of the count and number 

Oattrioutes come from the operands 
of macro instructions . 

The values of the type, length, 
scaling, and integer attributes, 
however, come from the values 
represented by the macro instruction 
operands, as follows: 

KB a. If the operand is a sublist, 
^^ the sublist as a whole has 

attributes; all the individual 
entries and the whole sublist 
have the same attributes as those 
of the first suboperand in the 
sublist (except for 'count', 
which can be different, and 
•number', which is relevant only 
for the whole sublist) . 

o. If the first character or 
characters of the operand (or 
sublist entry) constitute an 
^fe ordinary symbol , and this symbol 
^^ is followed by either an 

arithmetic operator (+,-,*, or 
/) , a left parenthesis , a comma , 
or a blank, then the values of 
the attributes for the operand 
are the same as for the ordinary 
symbol. 

Oc. If the operand (or sublist 
entry) is a character string 
other than a sublist or the 
character string described in 
b. above, the type attribute 
is undefined (U) and the length, 
scaling, and integer attributes 
are invalid. 



Attribute 
Notation 



Variable 
Symbol 



Symbolic 
parameter 
or 
&SYSLIST 




Macro Instruc- 
tion Operand 



N '&SYSLIST 
N'&SYSLIST(n) 



Symbolic 

parameter 

as inner 

macro 

instruction 

operand 



Sublist 
(A, B, C) 



Sublist 
entry 



Ordinary 
Symbol 



o 



Character string 
not beginning 
with a symbol 



Statement 
Label 



EXTRN 
or 

WXTRN 
Operand 
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VALUES: Because attribute references 
are allowed only in conditional 
assembly instructions, their values 
are available only at pre-assembly 
time, except for the length attribute, 
which can be referred to outside 
conditional assembly instructions 
and is therefore also available 
at assembly time (see C4C) . 

NOTE: The system variable symbol, 
SSYSLIST, can be used in an attribute 
reference to refer to a macro 
instruction operand, and, in turn, 
to an ordinary symbol. Thus, any 
of the attribute values for macro 
instruction operands and ordinary 
symbols listed below can also be 
substituted for an attribute 
reference containing SSYSLIST. 

THE TYPE ATTRIBUTE (T') : The type 
attribute has a value of a single 
alphabetic character that indicates 
the type of data represented by: 



• An ordinary symbol 



O 

DOS NOTE: An ordinary symbol outside a 
only macro cannot be used as the operand 
of T 1 inside a macro in DOS assembler 

^P • A macro instruction operand 

NOTE: The type attribute of a 
sublist is set to the same value as 
the type attribute of the first 
element of the sublist. 



OS 
only 



A SET symbol. A 



OS 
only 



The type attribute reference can 
be used only in the operand field 
of the SETC instruction or as one 
of the values used for comparison 
in the operand field of a SETE or 
AIF instruction. 



NOTE: Ordinary symbols used in 

the name field of an EQU instruction 

have the type attribute value "U". 

However, the third operand of an 
EQU instruction can be used 
explicitly to assign a type attribute 
value to the symbol in the name 
field. 





■■ 


Type 
Attribute 


Data Characterized 




%J For ordinary symbols and outer macro instructions 
that are symbols 




: Defined as labels for DC and DS instructions 


A 

B 
C 
D 

E 
F 
G 
H 
K 
L 

o* Q 

S 
V 
X 
Y 

z 


A-type constant, implicit length, aligned (also CXO _^ 

instruction label) wwr 

Binary Constant 

Character Constant 

Long floating-point constant, implicit length, aligned 

Short floating-point constant, implicit length, aligned 

Full-word fixed-point constant, implicit length, aligned 

Fixed-point constant, explicit length 

Half-word fixed-point constant, implicit length, aligned 

Floating-point constant, explicit length 

Extended floating-point constant, implicit length, aligned 

Packed decimal constant 

Q-type addnws constant, implicit length, aligned 

A-, S-, Q-, V- or Y-type address constant, explicit length 

S-type address constant, implicit length, aligned 

V-type address constant, implicit length, aligned 

Hexadecimal constant 

Y-type address constant, implicit length, aligned 

Zoned decimal constant 




: Defined as labels for assembler language statements 


1 

M 
W 


Machine instruction 
Macro Instruction 
CCW instruction 


J 


: Identified as control section name 


T 
$ 


: Identified as external symbol by EXTRN or 
WXTRN instruction 


© 

N 



A macro Instruction Operand that is: 

A self-defining term 

Omitted {has a value of a null character string) 


only ^m 


Tha vriut of a SfTA or SST8 variaM* 



tj , 



) 
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When a symbol or macro instruction 
operand cannot be assigned any of 
the type attribute values listed 
in the preceding figure, the data 
represented is considered to be 
undefined and its type attribute 
is U. Specific cases of where U 
is assigned as a type attribute 
value are given in the figure to 
the right. 

The type attribute will be set to U 
when the same ordinary symbol is used 
to define a label in more than one 
place, even though only one label 
will be generated by conditional 
assembly statements. 



O THE LENGTH ATTRIBUTE (L') : The 
length attribute has a numeric value 
equal to the number of bytes occupied 
by the data that is represented 
by the symbol specified in the 
attribute reference. 

If the length attribute value is 
desired for pre-assembly processing, 
the symbol specified in the attribute 
reference must ultimately represent 
-^ the name entry of a statement in 
^P open code. In such a statement, 
the length modifier (for EC and 
DS instructions) or the length field 
(for a machine instruction) , if 
^^ specified, must be a self -defining 
^y term. The length modifier or length 
field must not be coded as a 
multiterm expression, because the 
assembler does not evaluate this 
expression until assembly time. 

The length attribute can also be 
specified outside conditional 
assembly instructions. Then, the 
length attribute value is not 
available for conditional assembly 

O processing, but is used as a value 
at assembly time. 

At pre-assembly time, an ordinary 
symbol used in the name field of 
an EQU instruction has a length 
attribute value of 1 . At assembly 
time, the symbol has the same length 
attribute value as the first symbol 
of the expression in the first 
operand of the EQU instruction. 

OS However, the second operand of an EQU 
oftiy instruction can be used to assign a 
length attribute value to the symbol 
in the name field. 
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The Type Attribute Value=U is assigned to the following: 



Ordinary symbols that are used as labels: 
»► for the LTORG instruction 
»» for the EQU instruction without a third operand 
»» that are defined more than once ■■ 
s» for DC and DS statements that contain variable symbols 
Example: Ul DC &X'l' 

DOS only 
>» for DC and DS statements that contain expressions as 
duplication factors 

Example: DC (AA BB)F'15' 



The SETC variable symbol 



OS only 

The system variable symbols: &SYSPARM. &SYSDATE, 

and&SYSTIME 



Macro instruction operands that specify literals. 

Inner macro instruction operands that are ordinary symbols. 



Source Module 



MACRO 



Open 
Code 



LENGTHS &P1,&P2 



AIF 



.MOVE ANOP 
MVC 



(L'&Pl LE 8) .MOVE 



&P2,&P1 



MEND 



OPEN START 



DATA DC 



AREA DS 



o 

FL7*7E+9' 

o 

XL (L 1 DATA) 



L'&P2=L'DATA=7l 



LENGTHS DATA , AREA. 





MVC 



AREA , DATA 



END 
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NOTES : 

1. The length attribute reference, 
when used in conditional assembly 
processing, can be specified only in 
arithmetic expressions (see L4) . 

2. A length attribute reference to a 
symbol with the type attribute value 
of M, N, 0, T, U, or $ will be 
flagged. The length attribute for the 
symbol will be given the default 
value of 1 . 

THE SCALING ATTRIBUTE (S ' ) : The 
scaling attribute can be used only 
when referring to fixed-point, 
floating-point, or decimal, 
constants. It has a numeric value 
that is assigned as shown in the 
figure to the right. 



NOTES : 

1 . The scaling attribute reference 
can be used only in arithmetic 
expressions (see L4) . 

2. When no scaling attribute value 
can be determined, the reference is 
flagged and the scaling attribute is 
given the value of 1 . 











Constant 

Types 

Allowed 


Type 

Attributes 

Allowed 


Value of Scaling 
Attribute Assigned 


Fixed-Point 


H,F,andG 


Equal to the value of the 
scale modifier 
(-187 through +346 


Floating- 
Point 


D,E,L, and K 


Equal to the value of the 
scale modifer 
(0 through 14 - D,E) 
(0 through 28 - L) 


Decimal 


PandZ 


Equal to the number 
of decimal digits 
specified to the right 
of the decimal point 
(0 through 31 - P) 
(0 through 16- Z) 


Examples: 

PACKED DC P'+12. 
ZONED DC Z'+12. 


34 5' S'PACKED=3 
345' S'Z0NED=3 



/T\ 



1 



^ 



Jt.s 
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THE INTEGER ATTRIBUTE (I'); The integer attribute has 
a numeric value that is a function of (depends on) the 
length and scaling attribute values of the data being 
referred to by the attribute reference. The formulas 
relating the integer attribute to the length and scaling 
attributes are given in the figure below. 

NOTE: The integer attribute reference can be used only 
in arithmetic expressions (see L4) . 














Values 
Of the 
Integer 
Attribute 


Constant 
Type 
Allowed 
(attribute 
value) 


Formula 

Relating the 

Integer to the ^^ 

Length and ^P 

Scaling 

Attributes 


Examples 




Fixed-point 
(H,F, and G) 


I»=8*L , -S'-1 


HALFCON DC HS6'-25.93' \ 

8*2-6-1 
ONECON DC FS8 '100.3E-2 1 ' 

8*4-8-1 


9 
23 


Floating-point 
(D,E,L, and K) 


when L'S8 
I'=2*(L , -1)-S* 


SHORT DC ES2'46.415' 1 
2* (4-1) -2 1 

LONG DC DS5'-3.729' 
2*(8-ll-R 


4 
9 


Only for L-Type 


when L' > 8 
I*=2*(L , -ll-S'-2 


EXTEND DC LS10 ' 5. 312' 1 
2*(16-1J-10 -2 ' J 


18 


Decimal equal to the 
number of decimal 
digits to the left of 
the assumed decimal 
point after the 
number is assembled 

Packed (P) 
Zoned (Z) 


I , =2*L , -S'-1 
I'^L'-S' 


PACK DC P'H-3.513' 

2*3-3-1 


2 

1 


/V" ■ 




K)3|513C| 

ZONE DC Z 1 3.513' 
4-3 
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THE COUNT ATTRIBUTE (K') : The count 
attribute applies only to macro 
instruction operands, to SET symbols, 
and to the system variable symbols. 
It has a numeric value that is equal 
to the number of characters: 

O* That constitute the macro 
instruction operand, or 

08 • That would be required t4 

the cufftfenfc **!•# Of tl§ .mm * 
Qor th# system variable 

NOTES : 

1. The count attribute reference 
can be used only in arithmetic 
expressions (see L4) . 

2. The count attribute of an omitted 
macro instruction operand has a 
default value of 0. 





Macro Instruction M 
Operands ^ 

All characters of operand 
are included 



ALPHA 

(SUB, LIST, ALL) 
2(10,12) 
'A' 'B' 

• • blank 
' ' null character string 
(omitted operand) 



SET Symbols A 

Delimiting apostrophes 
not included 



OS only 



&C SETC 
&C SETC 
&C SETC 



&B 
&B 

&A 
&A 



SETB 
SETB 

SETA 
SETA 



'ALPHA 1 



1 


399 
X'FF' 



K*&C» 

K'&C» 

K'&B* 
K'4B» 

K'&A* 
K'&A» 



\ 



255 



&A SETA 0100 



K'&A= 



leading zeros are 
not counted 



System Variable Symbols 0^ 

&SYSNDX= 0912 IT&SYSNDX 



Value of Count 
Attribute 



5 
14 
8 
6 
3 
2 




leading zeros 
are counted 



Wy 
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THE NUMBER ATTRIBUTE (N') ; The 
number attribute applies only to 
the operands of macro instructions. 
It has a numeric value that is equal 
to the number of sublist entries 
in the operand. 

NOTES : 

1. The number attribute reference 
can be used only in arithmetic 
expressions (see L4) . 

2. N'&SYSLIST refers to the number 
of positional operands in a macro 
instruction, and N * SSYSLIST (m) 
refers to the number of sublist 
entries in the m-th operand (for 
further details on the number 
attribute of SSYSLIST, see J7C) . 



c 













Macro Instruction 
Operand Sublist 


Value of 
Number Attribute 








1 + number of commas 
separating the entries 




o 




(A,B,C,D,E) 
(A^,B,C,D,E) 




5 
6 

4 
1 
1 




/ omitted entry | 


I 

(A) 


,C,D) 


A 


When operand is 
not a sublist 






(No operands) 















^^Jf 
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L1C - SEQUENCE SYMBOLS 



Purpose 



You can use a sequence symbol in the name field of a 
statement to branch to that statement at pre-assembly time, 
thus altering the sequence in which the assembler processes 
your conditional assembly and macro instructions. You 
can thereby select the model statements from which the 
assembler generates assembler language statements for 
processing at assembly time. 



Secj. Sym. 



Specifications 



Sequence symbols must be specified 
as shown in the figure to the right. 



Format 




period (or dot) 

alphabetic character 

to 6 alphameric characters 



Examples: . sEQ 

• A1234 

• #924 



o 



Sequence symbols can be specified 
in the name field of assembler 
language statements and model 
statements, except as noted in the 
figure to the right. 



Statements in which 
sequence symbols must not 
be used as name entries 



The following assembler instructions: 



COPY 

EQU 

GBLA 

GBLB 

GBLC 

ICTL 

ISEQ 

LCLA 

LCLB 

LCLC 

MACRO 

OPSYN 



The Macro prototype 
instruction 



Any instruction that already 
contains an ordinary symbol 
or variable symbol 



G 



> 
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Sequence symbols can be specified 
in the operand field of an AIF or 
AGO instruction to branch to a 
statement with the same sequence 
symbol as a label. 

A sequence symbol has a local scope. 
Thus, if a sequence symbol is used 
in an AIF or AGO instruction, the 
sequence symbol must be defined 
as a label in the same part of the 
program in which the AIF or AGO 
instruction appears; that is, in 
the same macro definition or in 
open code. 

NOTE: A sequence symbol in the 
name field of a macro instruction 
is not substituted for the parameter, 
if specified, in the name field 
of the corresponding prototype 
statement (for specifications about 
the name entry of macro instructions 
see K2A) . 



Source Module 





MACRO 




&K&ME 

o 


MACONE 




AGO 


. GENERAT 


.GENERAT 


ANOP 




&HAME 


DS 


OH 



MEND 
MACRO 





MAC TWO 




© 


• 




•GENERAT 


ANOP 






AGO 


. GENERAT 



MEND 



Open 
code 



Q*EN 



. THERE 




DS OH 



END 
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L2 - Declaring Set Symbols 






You roust declare a SET symbol before 
you can use it. In the declaration, 
you specify whether it is to have 
a global or local scope. The 
assembler assigns an initial value 
to a SET symbol at its point of 
declaration. 



L2A — THE LCLA # LCLB, AND LCLC 
INSTRUCTIONS 



Purpose 



You use the LCLA, LCLB, and LCLC 
instructions to declare the local 
SETA, SETB, and SETC symbols you 
need . 



Specifications 



The format of the LCLA, LCLB, and 
LCLC instruction statements is given 
in the figure to the right. 

These instructions can be used 
anywhere in the body of a macro 
definition or in the open code 
portion of a source module. 

the LCLA, LCLE, and I»CLC 
instructions, If specified, must 
appear Jj8med£ate3.y following any 
GBLA, GBLB, or GBLC instructions 
that may fee ■ mp9e±£'im&-. 

If specified inside a macro 

definition, the global declaration*. . ,^ 
instructions must appear immediately 
following the macro prototype 
statement, if specified outside 
a macro definition, the global 
declarations must appear first in 
open code; that is* they must folM&i, 
any source macro definitions : ; $ 
specified a»# -pm&m&e the beginning 
of the first control section . A 









LCLA 
LCLB 
LCLC 


Name 


Operation 


Operand 


Blank 


LCLA, 
LCLB, or 
LCLC 


One or more variable 
symbols separated 
by commas 
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Any variable symbols declared in 
the operand field have a local 
scope. They can be used as SET 
symbols anywhere after the pertinent 
LCLA, LCLB, or LCLC instructions, 
but only within the declared local 
scope. 




Source Module 



MACRO 




&A2 cannot be used 
here, outside its de - 
dared scope 



MEND 
MACRO 




&A2 cannot be used 
here, before its de - 
claration 



MEND 



&A2 cannot be used 
here, outside its de - 
dared scope 
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The assembler assigns initial values 
to these SET symbols as shown in 
the figure to the right. 



Instruction 


Initial Value assigned 
to SET variable symbols 
in operand fields 


LCLA 
LCLB 
LCLC 





Null character 
string 



/0\ 



LOCAL VARIABLE SYMBOLS MUST NOT 
BE MULTIPLY DEFINED; A local SET 
variable symbol declared by the 
LCLA, LCLB, or LCLC instruction 
must not be identical to any other 
variable symbol used within the 
same local scope. The following 
rules apply to a local SET variable 
symbol: 

1. Within a macro definition, it 

Omust not be the same as any symbolic 
parameter declared in the prototype 
statement. 

2. It must not be the same as any 
4fo global variable symbol (see L2E) 
^^ declared within the same local 

scope. 

3. The same variable symbol must 
not be declared or used as two 

£ k different types of SET symbols, 
for example, as a SETA and a SETB 
symbol, within the same local scope. 

NOTE 1: A local SET symbol should 
not begin with the four characters 
6SYS, which are reserved for system 
variable symbols (see J7) . 

DOS NOTE 2: The global declarations 
^^ roust precede the local declarations. 



Source Module 



MACRO 



± 



MULTDEF 



tfPARAM 



A 



O 



LCLA *ARITJ$ 

LCLB ft ft BOOLEAN 

LCLC *CHARSTR 

GBLA 

GBLB 

GBLC 




V 



MEND 



Not considered 
as multiply 
defined because 
they are used in 
different local 
scopes 



L 

O 
C 
A 

L 

2 



START 
LCLA 
LCLB 
LCLC 
JGBLA 
Q<GBLB 

(gblc 

END 



&MAINA,4ARXTiiv; ; ;i 
&MAINB , &BOOI»E^ 
&MAINC , *CHA&$T^,&PARAM 




Correct definition 
of SETC symbol 
(no symbolic 
parameters 
allowed in 
open code) 



^y 
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SUBSCRIPTED LOCAL SET SYMBOLS; 
A local subscripted SET symbol is 
declared by the LCLA, LCLB, or LCLC 
instruction. This declaration roust 
be specified as shown in the figure 
to the right. 

The maximum dimension allowed is 
32,767. 



:'$8*e ' : &iM*i&&$$ 



O 



The dimension indicates the number 
of SET variables associated with 
the subscripted SET symbol. The 
assembler assigns an initial value 
to every variable in the array thus 
declared. 

NOTE: A subscripted local SET 
symbol can be used only if the 
declaration has a subscript, which 
represents a dimension; a 
nonsubscripted local SIT symbol 
can be used only if the declaration 
had no subscript. 



Format: 

LCLA 
LCLB, 
or LCLC 



&SETSYM(| dimension!) 

o 



I 



Variable 
Symbol 



Must be an unsigned 
decimal self-defining 
term but not zero 



Format: 



Instruction 



LCLA 
LCLB 
LCLC 



0^Wmi 



Example: 

LCLB &B(10) 



Array Defined 
Same initial values as for non-subscripted 
SET symbols 



I o I o I \ 

o 1 o 1 o I o I ** 

>s Mfcll I nul l I null I \ 
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L2B — THE GBLA, GBLB, ANE GBLC 
INSTRUCTIONS 



Purpose 



You use the GELA, GELE, and GBLC 
instructions to declare the global 
SETA, SETB, and SETC symbols you 
need. 









GBLA 
GBLB 
GBLC 


Name 


Operation 


Operand 


Blank 


GBLA, 
GBLB, or 
GBLC 


One or more variable 
symbols separated 
by commas 






Specifications 



The format of the GBLA, GELE, and 
GBLC instruction statements is given 
in the figure to the right. 

These instructions can be used 
anywhere in the body of a macro 
definition or in the open code 
portion of a source module. 

If specified inside a macro 
definition, the GBLA, GBLB, and 
GBLC instructions oust appear 
immediately following the macro 

$^o*ot#oje "; .. M^^§^U0XX"^^^^&^S:B 
outside a macro definition* the 
global declarations most appear 

fire* in o$en eoAe; '.tfcot is, they 

; :i 3iiiii:iiiiilil' 



the beginn 
section. 



of the first control 



Any variable symbols declared in 
the operand field have a global 
scope. They can be used as SET 

O symbols anywhere after the pertinent 
GBLA, GBLB, or GBLC instructions. 
However, they can be used only 
within those parts of a program 
in which they have been declared 
^^ as global SET symbols, that is in 
^P any macro definition and in open 4fc 
code. ^^ 

NOTE: Values can be passed between: 

©• The macro definitions, MAC1 , 
and MAC2, only by using the variable 
symbols SB and SC. 

O* The macro definition, MAC2, and 
open code, only by using the variable 
symbol SC. 

O* The macro definition, MAC1, and 
open code, only by using the variable 
symbol SC. 

008 NOTE: The m J 



Source Module 



Open 
Code 



MACRO 



MAC1 

GBLA &A 

GBLB &B 

GBLC &C 



&B cannot be used 
here, before its 
declaration 





V W 



MEND 



START 



GBLC &C 



W' END 



<^> 



SBcannot be used 
here, because it 
has not been de - 
dared in open 
code 



€ 
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The assembler assigns initial values 
to these SET symbols as shown in 
the figure to the right. 



Instruction 


Initial Value assigned 
to SET variable symbols 
in operand field 


GBLA 
GBLB 
GBLC 




Null character string 



The assembler assigns this initial 
value to the SET symbol only when 
it processes the first GBLA, GBLB, 

' or GBLC instruction in which the 
symbol appears. Subsequent GBLA, 

I GBLB, or GBLC instructions do not 
reassign ah initial value to the 
SET symbol. 



;M* »0T£2 The 



most precede the START 



instruction 
instruction. 



Source Module 




&A=0 



MEND 




Processing 
Sequence 



value of &A 
can be changed 
in expansion of 
macro FIRST 



&A can be 
used here 



END 



XZ 



&A= assigned value 



f 
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GLOBAL VARIABLE SYMEOIS MUST NOT 
BE MULTIPLY DEFINED: A global SET 
variable symbol declared by the 
GBLA, GBLB, or GELC instruction 
must not be identical to any other 
variable symbol used in open code 
or within the same macro definition. 
The following rules apply to a 
global SET variable symbol: 

1. Within a macro definition, it 

Omust not be the same as any symbolic 
parameter declared in the prototype 
statement. 

2. It must not be the same as any 
^h local variable symbol (see L2A) 
^^ declared within the same local 

scope. 

3. The same variable symbol must 
^^ not be declared or used as two 

O different types of global SET symbol, 
for example, as a SETA or SETB 
symbol. 

NOTE 1: A global SET symbol should 
not begin with the four characters 
6SYS, which are reserved for system 
variable symbols (see J7) . 

00S NOTE 2s The global declarations 

4t oust precede the local declarations* 



Source Module 



^o 






MACRO 



MULTGLOB 



&PARAM 



LCLA 
LCLB 
LCLC 

GBLA 

4GBLB 

GBLC 




&GA 



&GC1,&GC2 



MEND 



These variable symbols 
communicate values 
between the macro 
MULTGLOB and 
open code. They are 
not multiply defined 



LCLA 
LCLC 

GBLA 

GBLB 
GBLC 

START 
END 




4GA 



U 



*GCl,iGC2 



GBLA "j 
GBLB » 
GBLC J 



SUBSCRIPTED GLOBAL SET SYMBOLS: 
A global subscripted SET symbol 
is declared by the GELA, GBLB, or 
GBLC instruction. This declaration 
must be specified as shown in the 
figure to the right. 

The maximum dimension allowed is 
32,767. 



DOS The maximum 
4095. 



dimension allowed is 



The dimension indicates the number 
of SET variables associated with 
the subscripted SET symbol. The 
assembler assigns an initia'l value 
to every variable in the array thus 
declared. 




& SETSYM (|dimension | ) 



Variable 
Symbol 



must be an unsigned 
decimal self-defining 
term, but not zero 



Format: 



Array Defined 

Same initial values as 

for non-subscripted SET symbols 



o --I Q I Q I Q I \» 
fr'io I 



2^ 



null j null | null | V 



Global arrays are assigned initial 
values only by the first global 
declaration processed, in which 
a global subscripted SET symbol 
appears 
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NOTES: 

^P 1. A subscripted global SET symbol 
can be used only if the declaration 
has a subscript, which represents , 

Oa dimension; a nonsubscripted global 
SET symbol can be used only if the 
declaration had no subscript. 

2. Wherever a particular global 
SET symbol is declared with a 
^^ dimension as a subscript, the 
^ p dimension must be the same in each 
declaration. 

j DOS NOTE: The "CBLB jSWITCH (50) " 

^ Instruction must precede the START 
A instruction. 



^k^y 



Source Module 



MACRO 




MAC1 




GBLA 


&A1.&A21AQ) -Q 


GBLB 


&SWITCH(5 I 0) 


GBLC 


&CHAR(10) ,&C 


© 


© 


ffeAl SETA 


*A2C22) A 


&C SETC 


•#CHAR(€) ' 



MEND 
MACRO 



MAC 2 
GBLB 



&SWITCH(50; 



Open 
Otxte 



MEND 



OPEN START 



GBLB 



© 

&SWITCH(50) 



END 



L3 - Assigning Values to Set Symbols 



L3A — THE SETA INSTRUCTION 



Purpose 



The SETA instruction allows you to assign an arithmetic 
value to a SETA symbol. You can specify a single value 
or an arithmetic expression from which the assembler will 
compute the value to assign. 

You can change the values assigned to an arithmetic or 
SETA symbol. This allows you to use SETA symbols as 
counters, indexes, or for other repeated computations that 
require varying values. 



Section Lr The Conditional Assembly Language 34 3 



Specifications 



The format of the SETA instruction 
statement is given in the figure 
to the right. 

The variable symbol in the name 
field must have been previously 
declared as a SETA symbol in a GBLA 
or LCLA instruction. 

The variafeiS- 
a 

The assembler evaluates the 
arithmetic expression in the operand 
field as a signed 32-bit arithmetic 
value and assigns this value to 
the SETA symbol in the name field. 
An arithmetic expression is described 
in L4A. 











SETA 


Name 


Operation 


Operand 


A variable 
symbol ^^ 

o 


SETA 




An arithmetic expression 






Allowable range of values 
-^through 2 31 -! 











o 



SUBSCRIPTED SETA SYMBOLS ; The SETA 
symbol in the name field can be 
subscripted, but only if the same 
SETA symbol has been previously 
declared in a GBLA or LCLA 
instruction with an allowable 
dimension. 

The assembler assigns the value 
of the expression in the operand 
field to the position in the declared 
array given by the value of the 
subscript. The subscript expression 
must not be 0, or have a negative 
value, or exceed the dimension 
actually specified in the 
declaration. 



LCLA &A1,&A2 

© 



LCLA &SUBSCRA(100) 



Must be in range | 
1 through 32767 i 



&SUBSCRA(20) SETA 



2000 



Must be an arithmetic 
expression allowed in 
operand of SETA 
instruction 



&SUBSCRA Array 

i i i i w i2ooore m 

It t t 



1 2 



20 



100 



&SUBSCRA(200) SETA 2000 *ERROR* NO 

4% VALUE ASSIGNED! 



&A1 



SETA &SUBSCRA(20) 



Value assigned 
&A1=2000 
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L3B — THE SETC INSTRUCTION 



Purpose 



The SETC instruction allows you to assign a character 
string value to a SETC symbol. You can assign whole 
character strings or concatenate several smaller strings 
together. The assembler will assign the composite string 
to your SETC symbol. You can also assign parts of a 
character string to a SETC symbol by using the substring 
notation (see L5) . 



You can change the character value assigned to a SETC 
symbol. This allows you to use the same SETC symbol with 
different values for character comparisons in several 
places or for substituting different values into the same 
model statement. 



\„*/ 



Specifications 



The format of the SETC instruction 
statement is given in the figure 
to the right. 

The variable symbol in the name 
field must have been previously 
declared as a SETC symbol in a GBLC 
or LCLC instruction. 

fif* '^he variable symbol is assigned 

The four options that can be 
specified in the operand field are: 

^p 1. A type attribute reference 

^W 2. A character expression (see LUB) 

^9 3. A substring notation (see L5) 

04. A concatenation of substring 
^^ notations, or character expressions, 
or both. 

••The assembler assigns the character 
^^ string value represented in the 
operand field to the SETC symbol 
in the name field. The string 
length must be in the range (null 
character string) through 255 
characters. 















SETC 1 


Format: 
Name 


Operation 


Operand 


A variable 
^^ symbols 


SETC 


One of four options, 
exemplified below 


© 

Value 


Examples: 


ABC 

ABC 

ABCDEF 
ABCDEF 


&C1 

&C2 
&C3 
&C4 


SETC 

SETC 
SETC 
SETC 


T 
T 


■ &DATA 

or 
* SYMBOL. 


K 






Must appear alone 
and must not be 
enclosed in 
apostrophes 




•ABC© 








Up to 255 characters 
enclosed in apostrophes 




tmmm 


BCBR* d/3) 


<D 




Up to 255 characters 
enclosed in apostrophes 









^BC ' . ' DEF ' 

or 
*.BC . 'ABCDEF' (4 


,3) 
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NOTE: When a SETA or SETB symbol 
is specified in a character 
expression, the unsigned decimal 
value of the symbol (with leading 
zeros removed) is the character 
value given to the symbol. 



Examples: 



4C1 SETC '4A1 1 
4C2 SETC ' 4A1 ' 
4C3 SETC '4A1' 



&C4 
4C5 



SETC 
SETC 



4C6 SETC 



'-200' 
•&A1» 



•00200 



Part of string 
represented 



4C7 SETC '4A1+1' 
4C8 SETC '1-4A1' 



Value of &A1 



200 

00200 

-200 






Not considered 
as leading zero 



30 
•30 



Character 
Value Assigned 
to SETC symbols 



•I 



200 
200 
200 



-200 




00200 



30+1 
1-30 




Format: 



Hi 



Arithmetic Expression must 
have a value in the range 1 
.through 32767 



Examples: 

4C1 SETC 




4FULLWRD 



4C2 SETC (3) 'ABC' 

4C3 SETC (3rABCDE' (1,31 



Value Assigned 
to SETC symbol 



Must be in the 
range 1 through 
255 



© 



FFF 




4C4A SETC OrABC'.'DEF 1 

© 

4C4B SETC •ABC'.Ol'ABCDEF' (4,3]|AB 



ABCABCABCDEJ 



EFDEF 






c 
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SUBSCRIPTED SETC SYMBOLS: The SETC 
symbol in the name field can be 
subscripted, but only if the same 
SETC symbol has been previously 
declared in a GBLC or LCLC 
instruction with an allowable 
dimension. 

The assembler assigns the character 
value represented in the operand 
field to the position in the declared 
array given by the value of the 
subscript. The subscript expression 
must not be r or have a negative 
value, or exceed the dimension 
actually specified in the 
declaration. 



LCLC 
LCLC 



&C1,&C2 ^^ 
&SUBSCRC(20)^ 



Must be in the 
range 1 through 
32767 



&SUBSCRC(10) SETC 



Must be an arithmetic 
expression allowed in 
the operand of a SETA 
instruction 



Array: 
&SUBSCRC 



'ABCDE' 

© 



I t t 



I ABCDE I % % 



1 2 



10 



20 



&SUBSCRC(25) SETC 'ABCDEF 1 **ERROR** No 

^L Value Assigned 



&C1 



SETC ' &SUBSCRC(10) ' 



Value assigned 
&C1=ABCDE 






L3C ~ THE SETB INSTRUCTION 



Purpose 



The SETB instruction allows you to assign a binary bit 
value to a SETB symbol. You can assign the bit values, 

or 1, to a SETB symbol directly and use it as a switch. 

If you specify a logical expression (see LUC) in the operand 
field, the assembler evaluates this expression to determine 
whether it is true or false and then assigns the values 

1 or respectively to the SETB symbol. You can use this 
computed value in condition tests or for substitution. 
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Specifications 






The format of the SETB instruction 
statement is given in the figure 
to the right. 

The variable symbol in the name 
field must have been previously 
declared as a SETE symbol in a GELE 
or LCLB instruction. 

OS The variable symbol is assigned 
only a type attribute value of H. 

The three options that can be 
specified in the operand field are: 

^m 1. A binary value (0 or 1) 



2. A binary value enclosed in 
parentheses 



OS NOTE: An arithmetic value enclosed 
only in parentheses is allowed. This 
value can be represented by an 
unsigned decimal self-defining term, 
a SETA symbol, or an attribute 
reference other than the type 
attribute reference. If the value 
is 0, the assembler assigns a value 
of to the symbol in the name . 
field. If the value is not 0, the 
assembler assigns a value of 1. 



3. A logical expression enclosed 
in parentheses (see L4C) . 

The assembler evaluates the logical 
expression, if specified, to 
determine if it is true or false. 
If it is true, it is given a value 
of 1; if it is false, a value of 
0. The assembler assigns the 
explicitly specified binary value 
(0 or 1) or the computed logical 
value (0 or 1) to the SETB symbol 
in the name field. 

I SUBSCRIPTED SETB SYMBOLS: The SETB 
symbol in the name field can be 
subscripted, but only if the same 
SETB symbol has been previously 
declared in a GBLE or LCLE 
instruction with an allowable 
dimension. 

The assembler assigns the binary 
value explicitly specified or 
implicit in the logical expression 
present in the operand field to 

'the position in the declared array 
given by the value of the subscript. 
The subscript expression must not 
be 0, or have a negative value, 

| or exceed the dimension actually 
specified in the declaration. 



SETB 



Format: 
Name 


Operation 


Operand 


A variable 
symbol 


SETB 


One of three options, 
exemplified below 


Examples: 


o 

Values 
Assigned 


&B1 

&B2 
&B3A 

&B3B 


SETB 

SETB 
SETB 

SETB 


o a 

(i) (J 

(2> GT 3)' 


> 

> 

false 

o 

true 




1 


1 




Greater J 
than 1 


(2 


LT 3) 
Less than| 







LCLB 
LCLB 



&B1,&B2 ^^ 
&SUBSCRB(50) A 



Must be in the 
range 1 through 
32767 



&SUBSCRB(10) SETB 



Array: 
&SUBSCRB 



© 



Must be an arithmetic 
expression allowed 
in operand of a SETA 
instruction 



t t 

1 2 



BZ3C 



t 

10 



} 

50 



&SUBSCRB(72) SETB 1 

J 

© 



** ERROR** No VALUE ASSIGNED 



&B1 



SETB &SUBSCRB(10) 



Value assigned 
&B1=1 



\=Jj 



f 

:^L,J 
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L4 - Using Expressions 

There are three types of expressions that you can use only 
in conditional assembly instructions: arithmetic, character, 
and logical. The assembler evaluates these conditional 
assembly expressions at pre-assembly time. 

Do not confuse the conditional assembly expressions with 
the absolute or relocatable expressions used in other 
assembler language instructions and described in C6. The 
assembler evaluates absolute and relocatable expressions 
at assembly time. 



LlA — ARITHMETIC (SETA) EXPRESSIONS 



Purpose 

You can use an arithmetic expression for assigning an 
arithmetic value to a SETA symbol, or for computing a value 
used during conditional assembly processing. 

An arithmetic expression can contain one or more SET 
symbols, which allows you to use arithmetic expressions 
wherever you wish to specify varying values, for example 
as: 

1. Subscripts for SET symbols, symbolic parameters, and 
6SYSLIST, and in substring notation. 

i|lpt|ii§^^ 



You can then control loops, vary the results of 
computations, and produce different values for substitution 
into the same model statement. 
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Specifications 



Arithmetic expressions can be used 
as shown in the figure to the right. 

NOTE: When an arithmetic expression 
is used in the operand field of 
a SETC instruction , the assembler 
assigns the character value 
representing the arithmetic 
expression to the SETC symbol, after 
substituting values into any variable 
symbols. It does not evaluate the 
arithmetic expression. 



Can be Used In 


Used As 


Example 


SETA instruction 


operand 


&A1 SETA &A1+2 


AIF instruction 

or 

SETB instruction 


comparand 
in arithmetic 
relation 


AIF (&A*10 GT 30) .A 


Subscripted SET 
symbols 


subscript 


&SETSYM(&A+10-&C) 


Substring notation 
(See L6) 


subscript 


'&STRING' (&A*2,&A-1) 


Subiist notation 


subscript 


subiist ( A ,3,0,0) 
when &A=1 
&PARAM(&A+1)=B 


&SYSLIST 


subscript 


&SYSLIST(&M+l,&N-2) 
&SYSLIST(N'&SYSLIST) 

A 


SETC instruction 


character 
string in 
operand 


&C SETC '5-10*&A' 

if &A=10 »A 

then &C=5-10*10^^ 



\^/ 
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The figure below defines an arithmetic expression (self- 
defining terms are described in CUE) . 



Arith. Exp. 



: ^^V 



Arithmetic 
Expression 



Length 
Scaling 
Integer 
Count 

or 
Number 




Operators Allowed 

Unary: + positive 

- negative 

Binary: + addition 

- subtraction 

* multiplication 
/ division 

Arith. Exp = Arithmetic Expression 
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The variable symbols that are allowed 
as terras in an arithmetic expression 
are given in the figure to the 
right. 



Variable 
Symbol 


Restrictions 


Example 


Value 


SETA 


none 


— 


_ 


SETB 


none 


— 


— 


SETC 1 
&SYSPARM J 

©Q§r 


value must be an 
unsigned decimal 
self-defining term 
in the range 
through 
2,147,483,647 

ftiMMMMVI^ 


&C 
&SYSPARM 


123 
2000 


Symbolic 
Parameters 


value must be a 
self-defining term 


&PARAM 
&SUBLIST(3) 


X'Al' 
C'Z' 


&SYSLIST(n) | corresponding 

operand or sublist 

&SYSLIST (n,m)J entr v must be 
a self-defining 

term 


&SYSLIST(3) 
&SYSLIST(3,2) 


24 
B'lOl' 


&SYSNDX 


none 


— 


— 



^y 
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RULES FQR CQPiNg ARITHMETIC 
EXPRESSIONS ; The following is a 
summary of coding rules for 
arithmetic expressions: « 

1. Both unary (operating on one 
value) and binary (operating on 
two values) operators are allowed 
in arithmetic expressions. 

2. An arithmetic expression can 
have one or more unary operators 
preceding any term in the expression 
or at the beginning of the 
expression. 

3. An arithmetic expression must 
not begin with a binary operator , 
and it must not contain two binary 
operators in succession . 

4. An arithmetic expression must 
not contain two terms in succession . 

5. An arithmetic expression must 
not contain blanks between an 
operator and a term nor between 
two successive operators. 

6. An arithmetic expression can 
contain up to 24 unary and binary 
operators and up to 11 levels of 
parentheses . 



to 1€ unary 

d, up to S ■ 



Note that the parentheses required 
for sublist notation, substring 
notation, and subscript notation 
count toward this limit. 



Operators 



Unary 


+,- 


Binary 


+,-,*./ 



Examples 




>-&A 
&A 



^ &A-&B 



Context determines whether a 
+ or — is a Unary or 
Binary operator 



' £> &A-&B 
B K 100 i £ > &A/&B+100 
- &D I "1> &C-&D 



e 
e 



&CiI- &D 

f*3 
/&A 

&C */&D 
&C + *&D 



> &C* (-&D) 



INVALID 

INVALID 

INVALID 
INVALID 



Leftmost operator between 
two terms is Binary 



X'FF'. (10*&x). INVALID 



\ 



T5 ¥ '101' 



INVALID 



Section L: The Conditional Assembly Language 353 



/f"\ 



© 



EVALUATION OF ARITHMETIC EXPRESSIONS : 
The assembler evaluates arithmetic 
expressions at pre- assembly time 
as follows: 

1. It evaluates each arithmetic 
term. 

2. It performs arithmetic operations 
from left to right. However: 

a. It performs unary operations 
before binary operations, and 

b. It performs the binary 
operations of multiplication 
and division before the binary 
operations of addition and 
subtraction . 

3. In division , it gives an integer 
result; any fractional portion is 
dropped. Division by zero gives 

a result. 



Examples of Arithmetic Expressions 


Value of Arithmetic 
Expression 




&A=5 Jjk 






&A* — X'A' =£ 5*+Io 


+50 




&A=10,&B=2 




(&A+10/&B =£ 10+(10/(2) =0 


15 




[(&A+10)/&B =£> 20/2^™=£> 


10 




&A=10 






&A/2 =£> 10/2 


5 




&A=11 






&A/2 ={> 11/2 


5 


o 


&A=1 






&A/2 =$> 1/2 


Q 




&A=1 




_ 


10*&A/2 =$> 10/2 


5 



^u' 



4. In parenthesized arithmetic 

O expressions, the assembler evaluates 
the innermost expressions first 
-_ and then considers them as arithmetic 
^ m terms in the next outer level of ^fe 
expressions. It continues this ^^ 
process until the outermost 
expression is evaluated. 

5. The computed result, including 
intermediate values, must lie in 
the range -2 34 through +2 31 -1. 




(X , FF'*2+&B-(&€/2+ 




■\a 



1 
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L4B -- ' CHARACTER (SETC) EXPRESSIONS 



Purpose 



The main purpose of a character expression is to assign 
a character value to a SETC symbol. You can then use the 
SETC symbol to substitute the character string into a model 
statement . 

You can also use a character expression as a value for 
comparison in condition tests and logical expressions (see 
LUC) . In addition, a character expression provides the 
string from which characters can be selected by the 
substring notation (see L5) . 

Substitution of one or more character values into a 
character expression allows you to use the character 
expression wherever you need to vary values for substitution 
or to control loops. 



Specifications 



Character (SETC) expressions can 
be used only in conditional assembly 
instructions as shown in the figure 
to the right. 











Char. Exp. 


Can be Used in 


Used As 


Example 


SETC instruction 


operand 


&C SETC 


• STRINGO ' 


AIF instruction 

or 

SETB instruction 


character 
string in 
character 
relation 


AIF C&C 


' EQ ' STRING1') .B 


Substring notation 
(SeeL5) 


first part 
of notation 


i 


SELECT ' 


(2,5)=ELECT 




character 
expression 







{ o 
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A character expression consists of any combination of 
characters enclosed in apostrophes. Variable symbols are 
allowed. The assembler substitutes the representation of 
their values as character strings into the character 
expression before evaluating the expression. 

Up to 255 characters are allowed in a character expression. 






NOTE: Attribute references are not allowed in character 
expressions. 















Variable 
Symbol 


Must not contain more than 
255 characters 
(including blanks) 


A 


Restrictions 


Example 




Value 
Substituted 


SETA 


sign and leading 
zeros are suppressed 
stand alone zero 
is used 


&A SETA -0201 
&C SETC '&A' 
&ZERO SETA 
&C SETC ' & ZERO • 


201 



SETB 


none 


&B SETB 1 


1 


SETC 


none 


&C1 SETC 'ABC 

&C2 setc •aci' 


ABC 


Symbolic 
Parameters 


none 


&PARAM=(ABC) 

&C1 SETC 'SPARAM' 


(ABC) 


System 

Variable 

symbols 


none 


&NUM SETC '&S 
if &SYSNDX=02 


YSNDX ' 
01 


0201 




leading zeros are 
not suppressed 

















M 



\j 



f 
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EVALUATION OF CHARACTER EXPRESSIONS ; 
The value of a character expression 
is the character string within the 
enclosing apostrophes, after the 
assembler performs any substitution 
for variable symbols. 

Character strings, including variable 
symbols, can be concatenated to 
each other within a character 
expression. The resultant string 
is the value of the expression used 
in conditional assembly operations: 
for example, the value assigned 
to a SETC symbol. 



A double apostrophe must be used to 
generate a single apostrophe as part 
of the value of a character 
expression. 

A double ampersand will generate a 
double ampersand as part of the value 
of a character expression. To 
generate a single ampersand in a 
character expression, use the 
substring notation, for example, 
(•&&'(1,D). 

NOTE: To generate a period, two 
periods must be specified after a 
variable symbol, or the variable 
symbol must have a period as part of 
its value. 



Examples 



Concatenation 
operator is 
a period (.) 



'ABC 

•&PARAM 1 

'A+B-CSD' 

'&A+10' 

•&A&A' 



-Jmanj 



mandatory 



&c:abc 
&cf&c 



r -— {optional 



•&Ci+10*&A l 
'ABC&C 



&C 



' ABC&C. DEF' 



•L" SYMBOL 1 

© 

■&C.505' 



Value of 
Variable 
Symbols 
Used 



SYMBOL 

10 
15 



DEF 
DEF 

&A=200 

&C=AREA 

&C=. 



null 



&Onull 



Value of 
Character 
Expression 



ABC 

SYMBOL 

A-fB-C*D 

10+10 
(Not 20) 
1515 



DEFABC 
DEFDEF 



\AREA+ 10*200 



ABC. 



null character 
string 

ABCDEF 



L'SYMBOL 

2.505 
2.505 



Resultant Value 
must be in the 
range through 
255 characters 



0-127 
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CONCATENATION OF CHARACTER STRING 
VALUES ; Character expressions can 
be concatenated to each other or 
to substring notations in any order.' 
This concatenated string can then 
be used in the operand field of 
a SETC instruction or as a value 
for comparison in a logical 
expression. 

The resultant value is a character 
string composed of the concatenated 
parts. 

NOTE: The concatenation character 
(a period) is needed to separate 
the apostrophe that ends one 
character expression from the 
apostrophe that begins the next. 



LUC — LOGICAL (SETB) EXPRESSIONS 



Purpose 



Page of GC33-4010-0 
Revised September 29, 1972 
By TNL GN33-8148 



Concatenated 
String 



•ABC . 'DEF' 

I Mandatory &M 



ABC'. rt ABCDEF' (4,3) 



Substring notation 
(See L 6) 



&C (4,3) . 'DEF' 



optional 



'&C (1,3)1 '&C (4,3) 

■ABC. 'AC (4,3) 'GHI 

' ABC ' . ' &C ' . ' GHI « 
'ABC. V . 'GHI' 



hull character string 



Value of 

Variable 

Symbol 



ABC&EF 



Resultant 
Character 
String 
Value 



ABCDEF 



ABCDEF 



DEFDEF 



"1 
ABCDEF 



ABCf)f|GHI 
ABCGHI 



ABCGHI 



Value must be 
in the range 
through 255 
characters 



You can use a logical (Boolean) 
expression to assign the binary 
value 1 or to a SETB symbol. 

You can also use a logical expression 
to represent the condition test 
in an AIF instruction. This use 
allows you to code a logical 
expression whose value (0 or 1) 
will vary according to the values 
substituted into the expression 
and thereby determine whether or 
not a branch is to be taken. 



Specifications 



Logical (SETB) expressions can be 
used only in conditional assembly 
instructions as shown in the figure, 
to the right. 









Logical Exp. 


Can be 
used in 


Used As 


Example 


SETB 
instruction 


operand 


&B1 SETB (&B2 OR 8 GT 3) 


AIF 
instruction 


condition 
test part 
of operand 


AIF (NOT &B1 OR 8 EQ 3XA 
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The figure on the opposite page defines a logical 
expression. 

NOTE: An arithmetic relation is two arithmetic expressions 
separated by a relational operator. A character relation 
is two character strings (for example, a character 
expression and a type attribute reference) separated by 
a relational operator. The relational operators are: 

EQ (egual) 

NE (not equal) 

LE (less than or equal) 

LT (less than) 

GE (greater than or equal) 

GT (greater than) 



V_>/ 
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Page of GC33-4010-0 
Revised September 29, 1972 
By TNL GN33-8148 






Arithmetic 
value or 

(see L3C) 




Outermost Expression 
must be enclosed in 
parentheses in SETB 
and AIF instructions 



Logical Operators Allowed 



addition 

multiplication 

negation 








Logical 
Expression 



Optional parentheses 
around terms and 
expressions at this level 



SETB 

Variable 

Symbol 





( 


)S only 
or 






or 





1 














Items optionally 
enclosed in 
parentheses 



Relatio nal Operators Allowed 

[equal 

| not equal 

| less than or equal 

[less than 

greater than or equal 

greater than 



Must be in the 
range through 
255 characters 



©OS 0-127 



Arithmetic 

Expression 

(defined in 

L4A) 



Character 
Expression 
(defined in 
L4B) 



Substring 
Notation 
(defined in 
L5A) 



Type 

Attribute 

Reference 



Concatenation 
of Character 
Expression and 
Substring 
Notation 



Must stand alone 
and not be enclosed 
in apostrophes 



Section L: The Conditional Assembly Language 361 



RULES FOR CODING LOGICAL EXPRESSIONS ; 
The following is a summary of coding 
rules for logical expressions: 

1. A logical expression roust not 
contain two logical terms in 
succession. 

2. A logical expression can begin 
with the logical operator NOT . 

3. A logical expression can contain 
two logical operators in succession; 
however, the only combinations 
allowed are: OR NOT or ANC NOT. 

The two operators roust be separated 
from each other by one or more 
blanks. 

4. Any logical term, relation, or 
inner logical expression can be 
optionally enclosed in parentheses. 

5. The relational and logical 
operators roust be iroroed lately 
preceded and followed by at least ^^ 
one blank or other special character , ^p 

6. A logical expression can contain 
up to 18 logical operators and up 
to 17 levels of parentheses. 




and op 



Note that the relational and other 
operators used by the arithmetic 
and character expressions in 
relations do not count toward this 
total. 



Examples of Logical Expressions 

(&A GT 100 OR '&C EQ F) 

NOT &B OR NOT (&AGT 100)) 



arithmetic relation 



character relation 

[ ' -™ ■ ' 



(NOT (**€ f BQ >¥*)) 



logical term 



logical expression 



<NOT (*i) OR (*§, 



i# and IALB&)) 



(NOT &B OR &A GE 10 AND &A LE 0) 



X 



( ' &C • EQ • ALLOC * ) 



n 



( ' SCEO/ALLOC) 



(&A NE 10) 



blank mandatory 
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EVALUATIO N OF LOGICAL EXPRESSIONS : 
The assembler evaluates logical 
expressions as follows: «■ 

1. It evaluates each logical tern, 
which is given a binary value of 

or 1. 

2. If the logical term is an 
arithmetic or character relation, 
the assembler evaluates: 

a. The arithmetic or character 
expression specified as values 
for comparison in these relations, 
and then 

b. The arithmetic or character 
1 relation , and finally 

c. The logical term, which is 
the result of the relation. 

If the relation is true, the 
logical term it represents is 
given a value of 1; if the 
relation is false, the term is 
given a value of 0. 

NOTE: If two comparands in a 
character relation have character 
values of unequal length, the 
assembler always takes the shorter 
character value to be less than 
the longer one. 

3. The assembler performs logical 
operations from left to right. 
However: 

a. It performs logical NOTs 
before logical ANDs and ORs, 
and 

b. It performs logical ANDs 
before logical ORs. 

4. In parenthesized logical ■■ 
expressions, the assembler evaluates 
the innermost expressions first 

and then considers their as logical^ 
terms in the next outer level of '^M 
expressions. It continues this 
process until the outermost 
expression is evaluated. 



Examples of Logical Expressions 




((&A NE 100) OR T'&AREA EQ ' &PARAM' (3 , 4) ) 

~s~ o 

('ABC LT 'ABCD') Always true 

(given a value of 1) 

© 



(&B AND NOT (5 GT 3) ) 




(&B AND (NOT (5 GT 3) ) ) 

o 



(&B OR &A AND ('&C EQ 'B')) 




(&B OR (&A AND ('&C' EQ 'B'))) 

e 
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L5 - Selecting Characters from a String 



i j ) 



L5A — SUBSTRING NOTATION 



Purpose 



The substring notation allows you to refer to one or ircre 
characters within a character string. You can therefore 
either select characters from the string and use them fcr 
substitution or testing, or scan through a complete string, 
inspecting each character. Ey concatenating substrings 
with other substrings or character strings, you can 
rearrange and build your own strings. 



S pecifications 



The substring notation can be used only in conditional 
assembly instructions as shown in the figure below. 



Can be 
Used in 


Used as 


Example 


Value Assigned 
to SETC symbol 


SETC 

instruction 

operand 


operand 


&C1 SETC 'ABC (1/3) 


ABC 


part of 
operand 


&C2 SETC 'aCl' (1,2) .'DEF' 


ABDEF 


SETB or 

AIF 

instruction 

operand 

(logical 

expression) 


Character 
value in 
comparand 
of character 
relation 


AIF ('&STRING' (1,4) EQ 'AREA').SEQ 
&B SETB ( '&STRING' (1,4) . '9' EQ 'FULL9') 













J 
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The substring notation must be 
specified as shown in the figure 
to the right. 

The character string is a character 
expression from which the substring 
is to be extracted. The first 
subscript indicates the first 
character that is to be extracted 
from the character string. The 
second subscript indicates the 
number of characters to be extracted 
from the character string, starting 
with the character indicated by 
the first subscript. Thus the 
second subscript specifies the 
length of the resulting substring. 







Substring 


■ Hi 

Examples 


o © 

Value of Variable 
Symbol 


Character Value 
of Substring 


'ABCDE' (1,5) 




ABCDE 


'ABCDE' (2,3) 




BCD 


•*C'(3,3) 


ABCDE 


CDE 


'aPARAM'{3,3) 


'((A+3)*10) 


A*3 




Must be in 
range through 
255 characters 















c 
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The character string must be a valid 

character expression with a length, 

N, in the range 1 through 255 characters. 

The length of the resulting substring 
must be within the range 0-255. 



The subscripts, e1, and e2, must be 
arithmetic expressions. The substring 
notation is replaced by a value that 
depends on the three elements: N, e1, 
and e2, as summarized below: 

^p In the usual case , the assembler 
generates a correct substring of 
the specified length. 

0^ When e1 has a value of zero or a 
^^ negative value, the assembler issues 
an error message. 

0^ When the value of e1 exceeds N , the 

^^ assembler issues a warning message, 

and a null string is generated. 

^k When e2 has a value of , the 
^U assembler generates the null 

character string. Note that if e2 
is negative, the assembler issues 
an error message. 

^fcwhen e2 indexes past the end of the 
^^ character expression (that is, 

e1 + e2 is greater than N+1) , tifft' ^ 

0$.., assembler £s#n#« a warning sess&gife! 

owlf, and generates a substring which 
includes only the characters up 
to the end of the character expres- 
sion specified. 



Character Expression 
of length N 



Arithmetic 
Expressions 



' te?^ 



Examples: Assume (KN2255 



0<e1<N, 0<e2<N,and 
e1 + e2SN + 1 

'ABCDEF' (2,5) 



N=6 



BCDEF 



fte1<0 

•ABCDEF' (0 J) ** E rror#* 



[Value of e2 disregarded | 



0e1>N 

' ABCDEF '(7,1) N=e ^warnjng* 



,e2=0 

V ABCDEF' (H,0) 

lvalue of e1 disregarded | 



|0<e1SN,0<e2<N,but 
f e1 + e2>N+1 

'ABCDEF '(3,5) N=6 ^WARNING* 
'ABCDEF' (3,4) 



Character Value 
of Substring 



null 



null 



null 



CDEF 
CDEF 



c 
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L6 - Branching 



L6A — The AIF INSTRUCTION 



Purpose 



The AIF instruction allows you to branch according to the 
result of a condition test. You can thus alter the sequence 
in which your assembler language statements are processed. 

The AIF instruction also provides loop control for 
conditional assembly processing, which allows you to control 
the sequence of statements to be generated. 

It also allows you to check for error conditions and thereby 
to branch to the appropriate MNOTE instruction to issue an 
error message. 






Specifications 



The AIF instruction statement must 
be specified as shown in the figure 
to the right. 



Name 



A sequence 
Symbol or 
Blank 



Operation 



AIF 




No blanks 
allowed between 
right parenthesis 
and sequence 
symbol 



o 
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tfhe assembler evaluates the logical 
expression in the operand field 

Oat pre- assembly time. If the logical 
expression is true (logical value=1) , 
©the next statement processed by 
the assembler is the statement named 
© by the sequence symbol . If it is 
false (logical value «0) , the next ^^ 
sequential statement is processed. %jf 



&A=10 




.CONTINU ANOP 



processing continues hart 



|&C=NO 




AIF («iC* Wfr «*gP) .OUT 
■ERROR ANOP 



JT \ 



processing continues here 



.OUT 




rif\ 



^ 
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/£*"%, 

V 



e 



The sequence symbol in the operand 
field is a conditional assembly 
label that represents an address 
at pre- assembly time. It is the 
address of the statement to which 
a branch is taken if the logical 
expression preceding the sequence 
symbol is true. 

The statement identified by the 
sequence symbol referred to in the 
AIF instruction can appear before 
or after the AIF instruction. 
However, the statement must appear 
within the local scope of the 
sequence symbol. Thus, the statement 
identified by the sequence symbol 
must appear: 

• In open code , if the corresponding 
AIF instruction does or 

• In the same macro definition 
in which the corresponding AIF 
instruction appears. 

The sequence symbols . EACK and 
.FORWARD are not multiply defined. 
No branch can be taken from open 
code into a macro definition or 
between macro definitions, regardless 
of nested calls to other macro 
definitions. 

NOTE: For compatibility, the 
assemblers described in this manual 
will process the AIFB instruction 
(BOS/360) in the same way they 
process the AIF instruction. 



Source Module 




open 
code 



MACRO 



MACAIF 



AIF ( ' &C ' EQ ' F ' ) .FORWARD 



AIF (&A GT 5) .BACK 



RD ANOP 



J 



MEND 



0P» 




START 

AIF (&D NE 200). FORWARD 

AIF ('aCHAR' NE ' ) ' ) .BACK 



RD ANOP 



END 



L6B — THE AGO INSTRUCTION 



Purpose 



The AGO instruction allows you to branch unconditionally. 
You can thus alter the sequence in which your assembler 
language statements are processed. This provides ycu with 
final exits from conditional assembly loops. 
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Specifications 



The AGO instruction statement must 
be specified as shown in the figure 
to the right. 









I 


Name 


Operation 


Operand 


A sequence 
symbol or 
blank 


AGO 


*9B5^ 


A sequence symbol 1 
[described in L1C | 






The statement identified by a 
sequence symbol referred to in the 
AGO instruction can appear before 
or after the AGO instruction. 
However, the statement must appear 
within the local scope of the 
sequence symbol. Thus, the statement 
identified by the sequence symbol 
must appear 

• In open code , if the corresponding 
AGO instruction does or 

i • In the same macro definition 
in which the corresponding AGO 
instruction appears. 

NOTE: For compatibility, the 
assemblers described in this manual 
will process the AGOB instruction 
(BOS/360) in the same way they 
process the AGO instruction. 



L6C — THE ACTR INSTRUCTION 



Source Module 



Open 
code 



MACRO 




MACAGO 



AGO .FORWARD 



ANOP 



AGO . BACK 



RD ANOP 



MEND 



OPJIK 



START 




AGO 



RD ANOP 



.FORWARD 



END 



* 



i I 

Nut— " ' 



J»s 



Purpose 



The ACTR instruction allows you to set a conditional 
assembly loop counter either within a macro definition 
or in open code. 

Each time the assembler processes an AIF or AGO branching 
instruction in a macro definition or in open code, the 
loop counter for that part of the program is decremented 
by one. When the number of conditional assembly branches 
taken reaches the value assigned by the ACTR instruction 
to the loop counter, the assembler exits from the macro 
definition or stops processing statements in open code. 
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By using the ACTR instruction, you 
avoid excessive looping during 
conditional assembly processing 
at pre-assembly time . 



Specifications 

The format of the ACTR instruction 
statement is given in the figure 
to the right. 









ACTR 


Name 


Operation 


Operand 


Sequence 
symbol or 
blank 


ACTR 


i^vettd arithmetic 
|*rr A) expression 


Defined in L4A 









to 



The ACTR instruction can appear 
anywhere in open code or within 
a macro definition. 

A conditional assembly loop counter 
-^ is set (or reset) to the value of 
^p the arithmetic expression in the 

operand field. The loop counter 

O has a local scope ; its value is 
decremented only by AGO and AIF 
instructions and reassigned only 
by ACTR instructions that appear 
within the same scope. Thus, the 
nesting of macros has no effect 
on the setting of individual loop 
counters. 

The assembler sets its own internal 
loop counter both for open code 
and for each macro definition, if 
neither contains an ACTR instruction. 
The assembler assigns a standard 
value of 4096 to each of these 
internal loop counters. 



Loop Counter 
for Main Code 



MACRO 


/ 


OUTER 


/ 




J 


ACTR 


im 







INNER 


m* 




V A 


ACTR 


200 




'"L 







MEND 



© 9 



START 



Open 
Code' 



ACTR M 





Loop Counter 
for Macro 
"OUTER" 



MACRO 
INNER 



ACTR 



ACTR 



Hi 

50 

c 

A 

25 



MEND 




Loop Counter 
for Macro 
"INNER" 




END 



\Jf 
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/O, 



e 



o 



LOOP COUNTER OPERATIONS : Within 
the local scope of a particular 
loop counter (including the internal 
counters run by the assembler) , 
the following occurs: 



1. Each time an AGO or AIF (also 
AGOB or AIFB) branch is executed, 
the assembler checks the loop counter 
for zero or a negative value. 

2. If the count is not zero or 
negative, it is decremented by one. 

3. If the count is zero , before 
decrementing, the assembler will 
take one of two actions: 



a. If it is processing 
instructions in open code, the 
assembler will process the 
remainder of the instructions in 
the source module as comments. 
Errors discovered in these 
instructions during previous 
passes are flagged. 

b. If it is processing 
instructions inside a macro 
definition, the assembler 
terminates the expansion of that 
macro definition and processes 
the next sequential instruction 
after the calling macro 
instruction. If the macro 
definition is called by an inner 
macro instruction, the assembler 
processes the next sequential 
instruction after this inner 
call , that is, continues 
processing at the next outer 
level of nested macros (for 
levels of nesting see K6A) . 

NOTE: The assembler halves the 
ACTR counter value when it encounters 
serious syntax errors in conditional 
assembly instructions. 



MACRO 



MACRO 



OUTER 



INNER 

AIF (&A EQ 5) .OUT 



INNER 



AGO .OUT 



MEND 



MEND 



START 




Counter for 

"INNER" 
=0 



AIF (&A EQ 5) .OU*: 




Counter for 

"OUTER" 
=0 



Open Code 
Counter =0 



o 
o 



AGO .OUT 



END 
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L6D — THE ANOP INSTRUCTION 



Purpose 






© 



You can specify a sequence symbol 
in the name field of an ANOP 
instruction, and use the symbol 
as a label for branching purposes. 

The ANOP instruction performs no 
operation itself, but you can use 
it to branch to instructions that 
already have symbols in their name 
fields. For example, if you wanted 
to branch to a SETA, SETS, or SETC 
assignment instruction, which 
requires a variable symbol in the 
name field, you could insert a 
labeled ANOF instruction immediately 
before the assignment instruction. 
By branching to the ANOP instruction 
with an AIF or AGO instruction, 
you would, in effect, be branching 
to the assignment instruction. 



Specifications 

The format of the ANOP instruction 
statement is given in the figure 
to the right. 

No operation is performed by an 
ANOP instruction. Instead, if a 
branch is taken to the ANOP 
instruction, the assembler processes 
the next sequential instruction. 









ANOP 




Name 


Operation 


Operand 




A sequence 
symbol or 
blank 


ANOP 


Not required 




Example 

AGO .SEqQ 

^ . SEQ ANOP 
^^&A SETA 10 
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L7 - In Open Code 






L7A — PURPOSE 



Conditional assembly instructions in open code allow ycu: 

1. To select at pre-assembly time statements or groups 

of statements from the open code portion of a source ircdule 
according to a pre- determined set of conditions. The 
assembler further processes the selected statements at 
assembly time . 

2. To pass local variable information from open code through 
parameters into macro definitions. 

3. To control the computation in and generation of iracrc 
definitions using global SET symbols. 

U. To substitute values into the model statements in the 
open code of a source module and control the sequence of 
their generation. 



H^ */ 



L7B — SPECIFICATIONS 



All the conditional assembly elements 
and instructions can be specified 
in open code. 

O Conditional assembly instructions 
can appear anywhere in open code, 
^^ but they must appear after any 
^a source macro definitions that are 
^^ specified. 

DOS The global and local declaration 
instructions (see L2) must appear 
first in open code; that is, they 
must follow any source macro 
definitions specified and precede 
the beginning of the first control 
section. 



Open 
Code 



Source Module 

pa I. .. J. i % ...... a; .uu; 



MM 



FIRST START 



END 



Start of first 
Control Section 



374 



The specifications for the 
conditional assembly language 
described in L1 through L6 also 
apply in open code. However, the 
following restrictions apply: 

1. To attributes in open code: For 
ordinary symbols, only references 
to the type, length, scaling, and 
integer attributes are allowed. 

NOTE: References to the number 
attribute have no meaning in 
open code, because SSYSLIST is 
not allowed in open code and 
symbolic parameters have no 
meaning in open code. 

2. To conditional assembly 
expressions in open code, as shown 
in the figure to the right. 



Expression 


Must not contain 


Arithmetic 
(SETA) 


* &SYSLIST 

> Symbolic parameters 

■► Any attribute references to symbolic parameters, 
or &SYSLIST,&SYSECT,&SYSNDX 


Character 
(SETC) 


*» SSYSLIST, &SYSECT,&SYSNDX 

S» Attribute references to &SYSLIST , &SYSECT , 
& S YSNDX , or to symbolic parameters 

> Symbolic parameters 


Logical 
(SETB) 


* Arithmetic expressions with the items listed above 

• Character expressions with the items listed above 
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L3 ~ Listing Optii 






Purpose 



The listing options allow you to 
print the conditional assembly 
statements in the sequence they 
are processed. You can thus follow 
the conditional assembly logic in 
open code or in the code within 
any macro definition. 



Specifications 



Conditional assembly statements 
in the open code of a source module 
or in a macro definition can be 
printed in the program listings 
in the order in which they are 
processed, including iterations. 
This must be requested by specifying 
the desired options in the PARM 
field of the EXEC statement for 
the assembler program (job control 
language) , or by specifying the 
options in fields set up by a program 
that dynamically invokes the 
assembler. The options are listed 
in the figure to the right. 

NOTE: For other listing options 
see J8. 



Option 


Action 


NOALOGIC 


No conditional assembly statements in open code 
are printed 


ALOGIC 


All conditional assembly statements in open code 
that are processed are printed, including iterations 


NOMLOGIC 


No conditional assembly statements inside macro 
definitions, called from your program, are printed. 
NOTE: Conditional assembly statements in source 
macro definitions are always printed along with the 
rest of the code in a source module (assuming the 
PRINT option LIST) 


MLOGIC 


All conditional assembly statements inside macro 
definitions, that are processed when you call the 
macro, are printed, including iterations 



=v 
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Appendix I: Character Codes 







| 8-Bit 


Character Set 






j EBCDIC 


Punch 




Hexa- j Printer j 


j Code 

> ^ 

| 00000000 


Combination 
12,0,9,8,1 


Decimal 

h ^ 




Decimal j Graphics j 
00 | | 


| 00000001 


12,9 


,1 


1 


01 | | 


| 00000010 


12,9 


,2 


2 


02 | | 


| 00000011 


12,9 


r3 


3 


03 | | 


| 00000100 


12,9 


,4 


4 


04 | | 


| 00000101 


12,9 


r5 


5 


05 | | 


| 00000110 


12,9 


,6 


6 


06 t 1 


j 00000111 


12,9 


r 7 


7 


07 | | 


| 00001000 


12,9 


,8 


8 


08 | | 


| 00001001 


12,9 


r8,l 


9 


09 | | 


| 00001010 


12,9 


,8,2 


10 


0A | | 


| 00001011 


12,9 


,8,3 


11 


0B | | 


| 00001100 


12,9 


,8,4 


12 


0C | | 


| 00001101 


12,9 


,8,5 


13 


0D | j 


j 00001110 


12,9 


,8,6 


14 


0E j j 


| 00001111 


12,9 


,8,7 


15 


OF j j 


j 00010000 


12,11 


L,9,8,l 


16 


10 | | 


| 00010001 


11,9 


,1 


17 


H 1 1 


| 00010010 


11,9 


,2 


18 


12 | | 


j 00010011 


11,9, 


,3 


19 


13 | | 


| 00010100 


11,9 


,4 


20 


14 | | 


j 00010101 


11,9 


,5 


21 


15 | | 


| 00010110 


11,9 


,6 


22 


16 | | 


| 00010111 


11, 9, 


,7 


23 


17 | | 


| 00011000 


11,9 


,8 


24 


18 | | 


| 00011001 


11,9 


,8,1 


25 


19 | | 


| 00011010 


11*9, 


,8,2 


26 


1A | | 


| 00011011 


11,9 


,8,3 


27 


IB | | 


| 00011100 


11,9 


,8,4 


28 


1C | | 


| 00011101 


11,9, 


,8,5 


29 


ID | | 


j 00011110 


11,9 


,8,6 


30 


IE | | 


| 00011111 


11,9 


,8,7 


31 


IF | | 


| 00100000 


11,0 


,9,8,1 


32 


20 j | 


| 00100001 


0,9,1 


33 


21 | | 


j 00100010 


0,9,2 


34 


22 | | 


| 00100011 


0,9,3 


35 


23 | | 


j 00100100 


0,9,4 


36 


24 | ) 


| 00100101 


0,9,5 


37 


25 | | 


j 00100110 


0,9,6 


38 


26 | | 


j 00100111 


0,9.7 


39 


27 | | 


j 00101000 


0,9,8 


40 


28 | | 


| 00101001 


0.9,8,1 


41 


29 | | 


| 00101010 


0,9.8,2 


42 


2A | | 


| 00101011 


0,9,8,3 


43 


2B | | 


| 00101100 


0.9,8,4 


44 


2C | | 


| 00101101 


0,9,8,5 


45 


2D | | 


| 00101110 


0,9,8,6 


46 


2E | | 


| 00101111 


0,9,8,7 


47 


2F | | 


| 00110000 


12,11,0,9,8,1 


48 


30 | | 


j 00110001 


9,1 


49 


31 | | 


1 00110010 


9,2 


50 


32 | 1 
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| 8-Bit 


Character Set 










| EBCDIC 


Punch 




Hexa- 


Printer 




| Code 


Combination 


Decimal 


Decimal 


Graphics 




i- ^ 





^ 


h i 





j 


J 00110011 


9,3 


51 


33 






| 00110100 


9,4 


52 


34 






| 00110101 


9,5 


53 


35 






| 00110110 


9,6 


54 


36 






j 00110111 


9,7 


55 


37 






| 00111000 


9,8 


56 


38 






| 00111001 


9,8.1 


57 


39 






| 00111010 


9.8,2 


58 


3A 






| 00111011 


9,8,3 


59 


3B 






j 00111100 


9,8,4 


60 


3C 






j 00111101 


9,8,5 


61 


3D 






1 00111110 


9,8,6 


62 


3E 






| 00111111 


9,8.7 


63 


3F 






| 01000000 




64 


40 


blank 




| 01000001 


12,0,9,1 


65 


41 






j 01000010 


12,0,9,2 


66 


42 






| 01000011 


12,0,9,3 


67 


43 






j 01000100 


12,0,9,4 


68 


44 






1 01000101 


12,0,9,5 


69 


45 






| 01000110 


12,0,9,6 


70 


46 






| 01000111 


12,0,9,7 


71 


47 






| 01001000 


12,0,9,8 


72 


48 






j 01001001 


12,8,1 


73 


49 






| 01001010 


12,8,2 


74 


4A 






j 01001011 


12,8,3 


75 


4B 


. (period) 




1 01001100 


12,8,4 


76 


4C 


< 




j 01001101 


12,8,5 


77 


4D 


( 




| 01001110 


12,8,6 


78 


4E 


+ 




j 01001111 


12,8,7 


79 


4F 






| 01010000 


12 


80 


50 


€ 




j 01010001 


12,11,9,1 


81 


51 






| 01010010 


12,11,9,2 


82 


52 






| 01010011 


12,11,9,3 


83 


53 






| 01010100 


12,11,9,4 


84 


54 






j 01010101 


12,11,9,5 


85 


55 






| 01010110 


12,11,9,6 


86 


56 






| 01010111 


12,11,9.7 


87 


57 






| 01011000 


12,11,9,8 


88 


58 






| 01011001 


11.8,1 


89 


59 






| 01011010 


11,8,2 


90 


5A 






| 01011011 


11,8,3 


91 


5B 


$ 




j 01011100 


11,8,4 


92 


5C 


* 




| 01011101 


1 H,8,5 


93 


5D 


) 




j 01011110 


11,8,6 


94 


5E 






| 01011111 


11,8,7 


95 


5F 






| 01100000 


11 


96 


60 


_ 




1 01100001 


0,1 


97 


61 


/ 




| 01100010 


11,0,9,2 


98 


62 






I 01100011 


11,0,9,3 


99 


63 






j 01100100 


11,0,9,4 


100 


64 






I 01100101 


11,0,9,5 


101 


65 






j 01100110 


11,0,9,6 


102 


66 






I 01100111 


11,0,9,7 


103 


67 






I 01101000 


11,0,9,8 


104 


68 






j 01101001 


0,8,1 


105 


69 






I 01101010 


12,11 


106 


6A 






I 01101011 


0,8,3 


107 


6B 


, (comma) 


i 



V 



y 



^^>'4 



I 



4 
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I 8-Bit 


Character 


Set 






EBCDIC 


Punch 






Hexa- j Printer 


Code 


Combination 


Decimal 


Decimal | Graphics 


— ^ 








y i 


|. — + 


, 01101100 


0,8,4 




108 


6C | % 


i 01101101 


0,8,5 




109 


6D | 


{ 01101110 


0,8,6 




110 


6E I 


| 01101111 


0,8,7 




111 


6F | 


| 01110000 


12,11,0 




112 


70 | 


i 01110001 


12,11,0,9, 


1 


113 


71 | 


j 01110010 


12,11,0,9, 


2 


114 


' 72 | 


j 01110011 


12,11,0,9, 


3 


115 


73 | 


| 01110100 


12,11,0,9, 


4 


116 


74 | 


| 01110101 


12,11,0,9, 


5 


117 


75 | 


! omoiio 


12,11,0.9, 


6 


118 


76 J 


| 01110111 


12,11,0,9, 


7 


119 


77 | 


| 01111000 


12,11,0,9, 


8 


120 


78 | 


J 01111001 


8,1 




121 


79 | 


j 01111010 


8,2 




122 


7A | 


| 01111011 


8,3 




123 


7B | # 


j 01111100 


8, a 




124 


7C j a 


| 01111101 


8,5 




125 


7D j • (apostrophe) 


| 01111110 


8,6 




126 


7E | = 


| 01111111 


8,7 




127 


7F | 


| 10000000 


12,0,8,1 




128 


80 | 


| 10000001 


12,0 f l 




129 


81 { 


| 10000010 


12,0,2 




130 


82 | 


| 10000011 


12,0,3 




131 


83 | 


| 10000100 


12,0,4 




132 


84 | 


| 10000101 


12,0,5 




133 


85 | 


| 10000110 


12,0,6 




134 


86 | 


| 10000111 


12,0,7 




135 


87 | 


| 10001000 


12,0,8 




136 


88 | 


i 10001001 


12,0,9 




137 


89 | 


i 10001010 


12,0,8,2 




138 


8A | 


| 10001011 


12,0,8,3 




139 


8B | 


| 10001100 


12,0,8,4 




140 


8C | 


I 10001101 


12,0,8,5 




141 


8D | 


| 10001110 


12,0,8,6 




142 


8E | 


i 10001111 


12,0,8,7 




143 


8F | 


j 10010000 


12,11,8,1 




144 


90 j 


| 10010001 


12,11,1 




145 


91 | 


| 10010010 


12,11,2 




146 


92 | 


| 10010011 


12,11,3 




147 


93 | 


| 10010100 


12,11,4 




148 


94 | 


| 10010101 


12,11,5 




149 


95 J 


! looiono 


12,11,6 




150 


96 | 


i 10010111 


12,11,7 




151 


97 | 


I 10011000 


12,11,8 




152 


98 | 


i 10011001 


12,11,9 




153 


99 | 


| 10011010 


12,11,8,2 




154 


9A | 


| 10011011 


12,11,8,3 




155 


9B | 


| 10011100 


12,11,8,4 




156 


9C | 


| 10011101 


12,11,8,5 




157 


9D | 


j 10011110 


12,11,8,6 




158 


9E | 


I 10011111 


12,11,8,7 




159 


9F j 


j 10100000 


11,0,8,1 




160 


A0 | 


j 10100001 


11,0,1 




161 


Al | 


| 10100010 


11,0,2 




162 


A2 j 


| 10100011 


11,0,3 




163 


A3 | 


| 10100100 


11,0,4 




164 


A4 | 
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1 8-Bit 


Character Set 










| EBCDIC 


Punch 




Hexa- 


Printer 




j Code 


Combination 


Decimal 


Decimal 


Graphics 




1- 


|. 





h -1 





.| 


| 10100101 


11,0,5 


165 


A5 






| 10100110 


11. 


0,6 


166 


A6 






| 10100111 


11. 


0,7 


167 


A7 






| 10101000 


11, 


0,8 


168 


A8 






| 10101001 


11 


0,9 


169 


A9 






| 10101010 


Hi 


0,8,2 


170 


AA 






| 10101011 


Hi 


0,8,3 


171 


AB 






| 10101100 


Hi 


,0,8,4 


172 


AC 






j 10101101 


Hi 


,0,8,5 


173 


AD 






| 10101110 


11 


0,8,6 


174 


AE 






| 10101111 


11. 


0,8,7 


175 


AF 






1 10110000 


12, 


11,0,8,1 


176 


BO 






j 10110001 


12, 


11,0,1 


177 


Bl 






| 10110010 


12, 


11,0,2 


178 


B2 






| 10110011 


12, 


11,0,3 


179 


B3 






| 10110100 


12, 


11,0,4 


180 


B4 






| 10110101 


12, 


11,0,5 


181 


B5 






| 10110110 


12, 


11,0,6 


182 


B6 






| 10110111 


12, 


11,0,7 


183 


B7 






| 10111000 


12, 


,11,0,8 


184 


B8 






1 10111001 


12, 


11,0,9 | 


185 


B9 






j 10111010 


12 


r 11, 0,8,2 


186 


BA 






| 10111011 


12, 


r ll,0,8,3 


187 


BB 






| 10111100 


12 


,11,0,8,4 


188 


BC 






| 10111101 


12, 


rH, 0,8,5 


189 


BD 






| 10111110 


12 


r 11, 0,8, 6 


190 


BE 






| 10111111 


12 


rll, 0,8,7 


191 


BF 






j 11000000 


12, 


,0 


192 


CO 






| 11000001 


12, 


,1 


193 


CI 


A 




| 11000010 


12, 


2 


194 


C2 


B 




| 11000011 


12, 


3 


195 


C3 


C 




j 11000100 


12, 


4 


196 


C4 


D 




| 11000101 


12, 


5 


197 


C5 


E 




| 11000110 


12, 


6 


198 


C6 


F 




| 11000111 


12, 


7 


199 


C7 


G 




| 11001000 


12, 


8 


200 


C8 


H 




| 11001001 


12, 


9 


201 


C9 


I 




j 11001010 


12, 


,0,9,8,2 


202 


CA 






| 11001011 


12 


,0,9,8,3 


203 


CB 






j 11001100 


12 


,0,9,8,4 


204 


CC 






| 11001101 


12, 


0,9,8,5 


205 


CD 






| 11001110 


12 


,0,9,8,6 


206 


CE 






| 11001111 


12 


,0,9,8,7 


207 


CF 






j 11010000 


11, 


,0 


208 


DO 






| 11010001 


11 


,1 


209 


Dl 


J 




| 11010010 


11 


,2 


210 


D2 


K 




| 11010011 


11 


,3 


211 


D3 


L 




| 11010100 


Hi 


4 


212 


D4 


M 




| 11010101 


11 


5 


213 


D5 


N 




| 11010110 


11 


,6 


214 


D6 , 


O 




I 11010111 


11. 


,7 


215 


D7 


P 




I 11011000 


11 


,8 


216 


D8 


Q 




I 11011001 


11 


,9 


217 


D9 


R 




I 11011010 


12 


,11,9,8,2 


218 


DA 






| 11011011 


12 


,11,9,8,3 


219 


DB 






I 11011100 


12 


,11,9,8,4 


220 


DC 






I 11011101 


12 


,11,9,8,5 


221 


DD 






















^A^jfii 



380 



o 






j 8-Bit 


Character Set 








""] 


| EBCDIC 


Punch 






Hexa- 


Printer 




j Code 
| 11011110 


Combination 
12,11,9,8,6 




j Decimal 

-+ 

| 222 


Decimal 


Graphics 


j 




DE 


| 11011111 


12,11,9.8,7 




| 223 


DF 






| 11100000 


0,8,2 




| 224 


E0 






| 11100001 


11,0,9,1 




| 225 


El 






| 11100010 


0,2 




| 226 


E2 


S 




| 11100011 


0,3 




| 227 


E3 


T 




| 11100100 


0,4 




| 228 


E4 


U 




| 11100101 


0,5 




| 229 


E5 


V 




| 11100110 


0,6 




| 230 


E6 


w 




| 11100111 


0,7 




| 231 


E7 


X 




| 11101000 


0,8 




| 232 


E8 


Y 




| 11101001 


0,9 




| 233 


E9 


Z 




| 11101010 


11,0,9,8,2 




| 234 


EA 






| 11101011 


11,0,9,8,3 




| 235 


EB 






| 11101100 


11,0, 9,8, 4 




| 236 


EC 






| 11101101 


11,0,9,8,5 




| 237 


ED 






| 11101110 


11,0,9,8,6 




| 238 


EE 






| 11101111 


11,0,9,8,7 




| 239 


EF 






| 11110000 







| 240 


F0 







| 11110001 


1 




| 241 


Fl 


1 




| 11110010 


2 




| 242 


F2 


2 




| 11110011 


3 




| 243 


F3 


3 




| 11110100 


4 




j 244 


F4 


4 




| 11110101 


5 




| 245 


F5 


5 




| 11110110 


6 




j 246 


F6 


6 




| 11110111 


7 




| 247 


F7 


7 




| 11111000 


8 




| 248 


F8 


8 




| 11111001 


9 




| 249 


F9 


9 




| 11111010 


12,11,0,9,8, 


2 


| 250 


FA 






| 11111011 


12,11,0,9,8, 


3 


| 251 


FB 






| 11111100 


12,11,0,9,8, 


4 


| 252 


FC 






| 11111101 


12,11,0,9,8, 


5 


| 253 


FD 






| 11111110 


12,11,0,9,8, 


6 


| 254 


FE 






1 11111111 


12,11,0,9,8, 


7 


| 255 


FF 
















L— _ ___—_— . 


_J 



Speciol Graphic Characters 






C Cent Sign * 


Asterisk 


^ Greater-thon Sign 


Period, Decimal Point 


Right Parenthesis 


? Question Mark 


^ Less-than Sign 


r Semicolon 


Colon 


( Left Parenthesis — > Logical NOT 


I Number Sign 


+ Plus Sign 


Minus Sign, Hyphen @ At Sign 


| Vertical Bar, Logical OR / Slash 


■ Prime, Apostrophe 


& Ampersand 


Comma 


= Equal Sign 


! Exclamation Point % Percent 


" Quotation Mark 


$ Dollar Sign 


Underscore 








Bit Pattern 


Hole Pattern 


Examples 


Type 


Bit Positions 












01 23 4567 


Zone Punches 


Digit Punches 


PF 


Control Character 


00 00 0100 


12-9-4 


% 


Special Graphic 


01 10 1100 


0-8-4 


R 


Upper Case 


11 01 1001 


11-9 


a 


Lower Cose 


10 00 0001 


12-0-1 




Control Character, 


0011 0000 


12- 11 -0 -9-8- 1 




function not yet 








assigned 




1 
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Appendix II: Hexadecimal-Decimal Conversion Table 



The table in this appendix provides for direct conversion of decimal and hexadecimal 
numbers in these ranges: 

r r 1 ' 

| Hexadecimal | Decimal J 

,. + ^ 

j 000 to FFF | 0000 to 4095 | 

L J J 

Decimal numbers (0000-4095) are given within the 5-part table. The first two characters 
(high-order) of hexadecimal numbers (000-FFF) are given in the lefthand column of the 
table; the third character (x) is arranged across the top of each part of the table. 

To find the decimal equivalent of the hexadecimal number 0C9, look for 0C in the left 
colum, and across that row under the column for x = 9. The decimal number is 0201. 

To convert from decimal to hexadecimal, look up the decimal number within the table 
and read the hexadecimal number by a combination of the hex characters in the left 
column, and the value for x at the top of the column containing the decimal number. For 
example, the decimal number 123 has the hexadecimal equivalent of 07B; the decimal 
number 1478 has the hexadecimal equivalent of 5C6. 






For numbers outside the range of the table, add the following values to the table 



1 


Hexadecimal 


1 


Decimal 


1 


k- 


1000 
2000 
3000 
4000 
5000 
6000 
7000 
8000 
9000 
AOOO 
BOOO 
COOO 
DOOO 
EOOO 
FOOO 


-+- 


4096 
8192 
12288 
16384 
20480 
24576 
28672 
32768 
36864 
40960 
45056 
49152 
53248 
57344 
61440 


H 


L_ 




-JL- 




_j 
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x * 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


P 


OOx 
01x 
02x 
03x 


OOOO 
0016 
0032 
0048 


0001 
0017 
0033 
0049 


0002 
0018 
0034 
0050 


0003 
0019 
0035 
0051 


0004 
0020 
0036 
0052 


0005 
0021 
0037 
0053 


0006 
0022 
0038 
0054 


0007 
0023 
0039 
0055 


0008 
0024 
0040 
0056 


0009 
0025 
0041 
0057 


0010 
0026 
0042 
0058 


0011 
0027 
0043 
0059 


0012 
0028 
0044 
0060 


0013 
0029 
0045 
0061 


0014 
0030 
0046 
0062 


0015 
0031 
0047 
0061 


04x 
05x 
06x 
07x 


0064 
0080 
0096 
0112 


0065 
0081 
0097 
0113 


0066 
0082 
0098 
0114 


0067 
0083 
0099 
0115 


0068 
0084 
0100 
0116 


0069 
0085 
0101 
0117 


0070 
0086 
0102 
0118 


0071 
0087 
0103 
0119 


0072 
0088 
0104 
0120 


0073 
0089 
0105 
0121 


0074 
0090 
0106 
0122 


0075 
0091 
0107 
0123 


0076 
0092 
0108 
0124 


0077 
0093 
0109 
0125 


0078 
0094 
0110 
0126 


007S 
0095 
0111 
012? 


08x 
09x 
OAx 
OBx 


0128 

out 

0160 
0176 


0129 
0145 
0161 
0177 


0130 
0146 
0162 
0178 


0131 
0147 
0163 
0179 


0132 
0148 
0164 
0180 


0133 
0149 
0165 
0181 


0134 
0150 
0166 
0182 


0135 
0151 
0167 
0183 


0136 
0152 
0168 
0184 


0137 
0153 
0169 
0185 


0138 
0154 
0170 
0186 


0139 
0155 
0171 
0187 


0140 
0156 
0172 
0188 


0141 
0157 
0173 
0189 


0142 
0158 
0174 
0190 


0143 
0153 
0175 
0191 


OCx 
ODx 
OEx 
OPx 


0192 
0208 
0224 
0240 


0193 
0209 
0225 
0241 


0194 
0210 
0226 
0242 


0195 
0211 
0227 
0243 


0196 
0212 
0228 
0244 


0197 
0213 
0229 
0245 


0198 
0214 
0230 
0246 


0199 
0215 
0231 
0247 


0200 
0216 
0232 
0248 


0201 
0217 
0233 
0249 


0202 
0218 
0234 
0250 


0203 
0219 
0235 
0251 


0204 
0220 
0236 
0252 


0205 
0221 
0237 
0253 


0206 
0222 
0238 
0254 


0207 
0223 
0239 
0255 


10x 
11x 
12x 
13x 


0256 
0272 
0288 
0304 


0257 
0273 
0289 
0305 


0258 
0274 
0290 
0306 


0259 
0275 
0291 
0307 


0260 
0276 
0292 
0308 


0261 
0277 
0293 
0309 


0262 
0278 
0294 
0310 


0263 
0279 
0295 
0311 


0264 
0280 
0296 
0312 


0265 
0281 
0297 
0313 


0266 
0282 
0298 
0314 


0267 
0283 
0299 
031S 


0268 
0284 
0300 
0316 


0269 
0285 
0301 
0317 


0270 
0286 
0302 
0318 


0271 
0287 
0303 
0319 


14x 
15x 
16x 
17x 


0320 
0336 
03S2 
0368 


0321 
0337 
0353 
0369 


0322 
0338 
0354 
0370 


0323 
0339 
0355 
0371 


0324 
0340 
0356 
0372 


0325 
0341 
0357 
0373 


0326 
0342 
0358 
0374 


0327 
0343 
0359 
0375 


0328 
0344 
0360 
0376 


0329 
034S 
0361 
0377 


0330 
0346 
0362 
0378 


0331 
0347 
0363 
0379 


0332 
0348 
0364 
0380 


0333 
0349 
0365 
0381 


0334 
0350 
0366 
0382 


0335 
0351 
0367 
0383 


18x 
19x 
1Ax 
IBx 


0384 
0400 
0416 
0432 


0385 
0401 
0417 
0433 


0386 
0402 
0418 
0434 


0387 
0403 
041? 
0435 


0388 
0404 
0420 
0436 


0389 
0405 
0421 
0437 


0390 
0406 
0422 
0438 


0391 
0407 
0423 
0439 


0392 
0408 
0424 
0440 


0393 
0409 
0425 
0441 


0394 
0410 
0426 
0442 


0395 
0411 
0427 
0443 


0396 
0412 
0428 
0444 


0397 
0413 
0429 
0445 


0398 
0414 
0430 
0446 


0399 
0415 
0431 
0447 


1Cx 
IDx 
1Ex 
1Px 


0448 
0464 
0480 
0496 


0449 
0465 
0481 
0497 


0450 
0466 
0482 
0498 


0451 
0467 
0483 
0499 


04S2 
0468 
0484 
0500 


0453 
0469 
0485 
0501 


0454 
0470 
0486 
0502 


0455 
0471 
0487 
0503 


0456 
0472 
0488 
OS04 


0457 
0473 
0489 
0505 


0458 
0474 
0490 
0506 


0459 
0475 
0491 
0507 


0460 
0476 
0492 
0508 


0461 
0477 
0493 
0509 


0462 
0478 
0494 
0510 


046? 
047* 
04*5 
0511 


20x 
21x 
22x 
23x 


0512 
0528 
0544 
0560 


0513 
0529 
0545 
0561 


0514 
0530 
0546 
0562 


0515 
0531 
0547 
0563 


0516 
0532 
0548 
0564 


0517 
0533 
0549 
0565 


0518 
0534 
0550 
0566 


0519 
0535 
0551 
0567 


0520 
0536 
0S52 
0568 


0521 
0537 
0553 
0569 


0522 
0538 
0554 
0570 


0523 
0539 
0555 
0571 


0524 
0540 
0556 
0572 


0525 
0541 
0557 
0573 


0526 
0542 
0558 
0574 


0527 
0543 
0559 
0575 


24x 

25x 
26x 
27x 


0576 
0592 
0608 
0624 


0577 
0593 
0609 
0625 


0578 
0594 
0610 
0626 


0S79 
0595 
0611 
0627 


0580 
0596 
0612 
0628 


0581 
0597 
0613 
0629 


0582 
0598 
0614 
0630 


0583 
0599 
0615 
0631 


0S84 
0600 
0616 
0632 


0585 
0601 
0617 
0633 


0586 
0602 
0618 
0634 


0587 
0603 
0619 
0635 


0588 
0604 
0620 
0636 


0589 
0605 
0621 
0637 


05 90 
0606 
0622 
0638 


0591 
0607 
0623 
0639 


28x 
29x 
2Ax 

2Bx 


0640 
0656 
0672 
0688 


0641 
0657 
0673 
0689 


0642 
0658 
0674 
0690 


0643 
0659 
0675 
0691 


0644 
0660 
0676 
0692 


0645 
0661 
0677 
0693 


0646 
0662 
0678 
0694 


0647 
0663 
0679 
0695 


0648 
0664 
0680 
0696 


0649 
0665 
0681 
0697 


0650 
0666 
0682 
0698 


0651 
0667 
0683 
0699 


0652 
0668 
0684 
0700 


0653 
0669 
0685 
0701 


0654 
0670 
0686 
0702 


0655 
0671 
0687 
0703 


2Cx 
2Dx 
2Ex 
2Fx 


0704 
0720 
0736 
0752 


0705 
0721 
0737 
0753 


0706 
0722 
0738 
0754 


0707 
0723 
0739 
0755 


0708 
0724 
0740 
0756 


0709 
0725 
0741 
0757 


0710 
0726 
0742 
0758 


0711 
0727 
0743 
0759 


0712 
0728 
0744 
0760 


0713 
0729 
0745 
0761 


0714 
0730 
0746 
0762 


0715 
0731 
0747 
0763 


0716 
0732 
0748 
0764 


0717 
0733 
0749 
0765 


0718 
0734 
0750 
0766 


0719 
0735 
0751 
0767 


30x 
31x 
32x 
33x 


0768 
0784 
0800 
0816 


0769 
0785 
0801 
0817 


0770 
0786 
0802 
0818 


0771 
0787 
0803 
0819 


0772 
0788 
0804 
0820 


0773 
0789 
0805 
0821 


0774 
0790 
0806 
0822 


0775 
0791 
0807 
0823 


0^76 
0792 
0808 
0824 


0777 
0793 
0809 
0825 


0778 
0794 
0810 
0826 


0779 
0795 
0811 
0827 


0780 
0796 
0812 
0828 


0781 
0797 
0813 
0829 


0782 
0798 
0814 
0830 


0783 
0799 
0815 
0831 


34x 
35x 
36x 
37x 


0832 
0848 
0864 
0880 


0833 
0849 
086$ 
0881 


0834 
0850 
0866 
0882 


0835 
0851 
0867 
0883 


0836 
0852 
0868 
0884 


0837 
0853 
0869 
0885 


0838 
0854 
0870 
0886 


0839 
0855 
0871 
0887 


0840 
0856 
0872 
0888 


0841 
0857 
0873 
0889 


0842 
0858 
0874 
0890 


0843 
0859 
0875 
0891 


0844 
0860 
0876 
0892 


0845 
0861 
0877 
0893 


0846 
0862 
0878 
0894 


0847 
0863 
0879 
0895 


38x 
39x 
3Ax 
3Bx 


0896 
0912 
0928 
0944 


0897 
0913 
0929 
0945 


0898 
0914 
0930 
0946 


0899 
0915 
0931 
0947 


0900 
0916 
0932 
0948 


0901 
0917 
0933 
0949 


0902 
0918 
0934 
0950 


0903 
0919 
0935 
0951 


0904 
0920 
0936 
0952 


0905 
0921 
0937 
0953 


0906 
0922 
0938 
0954 


0907 
0923 
0939 
0955 


0908 
0924 
0940 
0956 


0909 
0925 
0941 
0957 


0910 
0926 
0942 
0958 


0911 
0927 
0943 
0959 


3Cx 
3Dx 
3Ex 
3Px 


0960 
0976 
0992 
1008 


0961 
0977 
0993 
1009 


0962 
0978 
0994 
1010 


0963 
0979 
0995 
1011 


0964 
0980 
0996 
1012 


0965 
0981 
0997 
1013 


0966 
0982 
0998 
1014 


0967 
0983 
0999 
1015 


0968 
0984 
1000 
1016 


0969 
0985 
1001 
1017 


0970 
0986 
1002 
1018 


0971 
0987 
1003 
1019 


0972 
0988 
1004 
1020 


0973 
0989 
1005 
1021 


0974 
0990 
1006 
1022 


0975 
0991 
1007 
1023 






r"\ 



384 





x « 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


•Ox 
• 1x 
«2x 
*3x 


1024 
1040 
1056 
1072 


1025 
1041 
1057 
1073 


1026 
1042 
1058 
1074 


1027 
1043 
1059 
1075 


1028 
1044 
1060 
1076 


1029 
1045 
1061 
1077 


1030 
1046 
1062 
1078 


1031 
1047 
1063 
1079 


1032 
1048 
1064 
1080 


1033 
1049 
1065 
1081 


1034 
1050 
1066 
1082 


1035 
1051 
1067 
1083 


1036 
1052 
1068 
1084 


1037 
1053 
1069 
1065 


1038 
1054 
1070 
1086 


1039 
1055 
1071 
1087 


•4x 
«5x 

46x 
«7x 


1088 
110H 
1120 
1136 


1089 
1105 
1121 
1137 


1090 
1106 
1122 
1138 


1091 
1107 
1123 
1139 


1092 
1108 
1124 
1140 


1093 
1109 
1125 
1141 


1094 
1110 
1126 
1142 


1095 
1111 
1127 
1143 


1096 
1112 
1128 
1144 


1097 
1113 
1129 
1145 


1098 
1114 
1130 
1146 


1099 
1115 
1131 
1147 


1100 
1116 
1132 
1148 


1101 
1117 
1133 
1149 


1102 
1118 
1134 
1150 


1103 
1119 
1135 
1151 


48x 
*9x 

4 Ax 
4Bx 


1152 
1168 
1184 
1200 


1153 
1169 
1185 
1201 


1154 
1170 
1186 
1202 


1155 
1171 
1187 
1203 


1156 
1172 
1188 
1204 


1157 
1173 
1189 
1205 


1158 
1174 
1190 
1206 


1459 
1175 
1191 
1207 


1160 
1176 
1192 
1208 


1161 
1177 
1193 
1209 


1162 
1178 
1194 
1210 


1163 
1179 
1195 
1211 


1164 
1180 
1196 
1212 


1165 
1181 
1197 
1213 


1166 
1182 

1198 
1214 


1167 
1183 
1199 
1215 


«Cx 
•Ox 
4Bx 

«rx 


1216 
1232 
12*8 
1264 


1217 
1233 
1249 
1265 


1218 
1234 
1250 
1266 


1219 
1235 
1251 
1267 


1220 
1236 
1252 
1268 


1221 
1237 
1253 
1269 


1222 
1238 
1254 
1270 


1223 
1239 
1255 
1271 


1224 
1240 
1256 
1272 


1225 
1241 
1257 
1273 


1226 
1242 
1258 
1274 


1227 
1243 
1259 
1275 


1228 
1244 
1260 
1276 


1229 
1245 
1261 
1277 


1230 
1246 
1262 
1278 


1231 
1247 
1263 
1279 


SOx 
S1x 
S2x 

S3x 


1280 
1296 
1312 
1328 


1281 
1297 
1313 
1329 


1282 
1298 
1314 
1330 


1283 
1299 
1315 
1331 


1284 
1300 
1316 
1332 


1285 
1301 
1317 
1333 


1286 
1302 
1318 
1334 


1287 
1303 
1319 
1335 


1288 
1304 
1320 
1336 


1289 
1305 
1321 
1337 


1290 
1306 
1322 
1338 


1291 
1307 
1323 
1339 


1292 
1308 
1324 
1340 


1293 
1309 
1325 
1341 


1294 
1310 
1326 
1342 


1295 
1311 
1327 
1343 


S4x 
55x 

56x 
57x 


13M 

1360 
1376 
1392 


1345 
1361 
1377 
1393 


1346 
1362 
1378 
1394 


1347 
1363 
1379 
1395 


1348 
1364 
1380 
1396 


1349 
1365 
1381 
1397 


1350 
1366 
1382 
1398 


1351 
1367 
1383 
1399 


1352 
1368 
1384 
1400 


1353 
1369 
1385 
1401 


1354 
1370 
1386 
1402 


1355 
1371 
1387 
1403 


1356 
1372 
1388 
1404 


1357 
1373 
1389 
1405 


1358 
1374 
1390 
1406 


1359 
1375 
1391 
1407 


58x 

59x 
SAx 

SBx 


1408 
1424 

umo 

1*56 


1409 
1425 
1441 
1457 


1410 
1426 
1442 
1458 


1411 
1427 
1443 
1459 


1412 
1428 
1444 
1460 


1413 
1429 
1445 
1461 


1414 
1430 
1446 
1462 


1415 
1431 
1447 
1463 


1416 
1432 
1448 
1464 


1417 
1433 
1449 
1465 


1418 
1434 
1450 
1466 


1419 
1435 
1451 
1467 


1420 
1436 
1452 
1468 


1421 
1437 
14S3 
1469 


1422 
1438 
1454 
1470 


1423 
1439 
1455 
1471 


SCx 
SOx 
SBx 

srx 


1472 
1*88 

150* 
1520 


1473 
1489 
1505 
1521 


1474 
1490 
1506 
1522 


1475 
1491 
1507 
1523 


1476 
1492 
1508 
1524 


1477 
1493 
1509 
1525 


1478 
1494 
1510 
1526 


1479 
1495 
1511 
1527 


1480 
1496 
1512 
1528 


1481 
1497 
1513 
1529 


1482 
1498 
1514 
1530 


1483 
1499 
1515 
1531 


1484 
1500 
1516 
1532 


1485 
1501 
1517 
1533 


1486 
1502 
1518 
1534 


1487 
1503 
1519 
1535 


60x 
61x 
62x 
63x 


1536 
1552 
1568 
1584 


1537 
1553 
1569 
1585 


1538 
1554 
1570 
1566 


1539 
1555 
1571 
1587 


1540 
1556 
1572 
1588 


1541 
1557 
1573 
1589 


1542 
1558 
1574 
1590 


154 3 
1559 
1575 
1591 


1544 
1560 
1576 
1592 


1545 
1561 
1577 
1593 


1546 
1562 
1578 
1594 


1547 
1563 
1579 
1595 


1548 
1564 
1580 
1596 


1549 
1565 
1581 
1597 


1550 
1566 
1582 
1598 


1551 
1567 
1583 
1599 


64x 
65x 
66x 
67x 


1600 
1616 
1632 
1648 


1601 
1617 
1633 
1649 


1602 
1618 
1634 
1650 


1603 
1619 
163S 
1651 


1604 
1620 
1636 
1652 


1605 
1621 
1637 
1653 


1606 
1622 
1638 
1654 


1607 
1623 
1639 
1655 


1608 
1624 
1640 
1656 


1609 
1625 
1641 
1657 


1610 
1626 
1642 
1658 


1611 
1627 
1643 
1659 


1612 
1628 
1644 
1660 


1613 
1629 
1645 
1661 


1614 
1630 
1646 
1662 


1615 
1631 
1647 
1663 


68x 
69x 
6Ax 
6Bx 


1664 
1680 
1696 
1712 


1665 
1681 
1697 
1713 


1666 
1682 
1698 
1714 


1667 
1683 
1699 
1715 


1668 
1684 
1700 
1716 


1669 
1685 
1701 
1717 


1670 
1686 
1702 
1718 


1671 
1687 
1703 
1719 


1672 
1688 
1704 
1720 


1673 
1689 
1705 
1721 


1674 
1690 
1706 
1722 


1675 
1691 
1707 
1723 


1676 
1692 
1708 
1724 


1677 
1693 
1709 
1725 


1678 
1694 
1710 
1726 


1679 
1695 
1711 
1727 


6Cx 
6Dx 
6Ex 
6Fx 


1728 
1744 
1760 
1776 


1729 
1745 
1761 
1777 


1730 
1746 
1762 
1778 


1731 
1747 
1763 
1779 


1732 
1748 
1764 
1780 


1733 
1749 
1765 
1781 


1734 
1750 
1766 
1782 


1735 
1751 
1767 
1783 


1736 
1752 
1768 
1784 


1737 
1753 
1769 
1785 


1738 
1754 
1770 
1786 


1739 
1755 
1771 
1787 


1740 
1756 
1772 
1788 


1741 
1757 
1773 
1789 


1742 
1758 
1774 
1790 


1743 
1759 
1775 
1791 


70x 
71x 
72* 
73x 


1792 
1808 
1824 
1840 


1793 
1809 
1825 
1841 


1794 
1810 
1826 
1842 


1795 
1811 
1827 
1843 


179 6 
1812 
1828 
1844 


1797 
1813 
1829 
1845 


1798 
1814 
1830 
1846 


1799 
1815 
1831 
1647 


1800 
1816 
1832 
1848 


1801 
1817 
1833 
1849 


1802 
1818 
1834 
1850 


1803 
1819 
1835 
1851 


1804 
1820 
1836 
1852 


1805 
1821 
1837 
1853 


1806 
1822 
1838 
1854 


1807 
1823 
1839 
1855 


74x 
75x 
76x 
77x 


1856 
1872 
1888 
1904 


1857 
1873 
1889 
1905 


1858 
1874 
1890 
1906 


1859 
1875 
1891 
1907 


1860 
1876 
1892 
1908 


1861 
1877 
1893 

1909 


1862 
1878 
1894 
1910 


1863 
1879 
1895 
1911 


1864 
1880 
1896 
1912 


1865 
1881 
1897 
1913 


1866 
1882 
1898 
1914 


1867 
1883 
1899 
1915 


1868 
1884 
1900 
1916 


1869 
1885 
1901 
1917 


1870 
18U6 
1902 
1918 


1871 
1887 
1903 
1919 


78x 
79x 
7Ax 
7Bx 


1920 
1936 
1952 
1968 


1921 
1937 
1953 
1969 


1922 
1938 
1954 
1970 


1923 
1939 
1955 
1971 


1924 
1940 
1956 
1972 


1925 
1941 
1957 
1973 


1926 
1942 
1958 
1974 


1927 
1943 
1959 
1975 


1928 
1944 
1960 
1976 


1929 
1945 
1961 
1977 


1930 
1946 
1962 
1978 


1931 
1947 
1963 
1979 


1932 
1948 
1964 
1980 


1933 
1949 
1965 
1981 


1934 
1950 
1966 
1982 


1935 
1951 
1967 
1983 


7Cx 
7Dx 
7EX 
7Px 


1984 
2000 
2016 
2032 


1985 
2001 
2017 
2033 


1986 
2002 
2018 
2034 


1987 
2003 
2019 
2035 


1988 
2004 
2020 
2036 


1989 
2005 
2021 
2037 


1990 
2006 
2022 
2038 


199T 
2007 
2023 
2039 


1992 
2008 
2024 
2040 


1993 
2009 
2025 

2041 


1994 
2010 
2026 
2042 


1995 
2011 
2027 
2043 


1996 
2012 
2028 
2044 


1997 
2013 
2029 
2045 


1998 
2014 
2030 
2046 


1999 
2015 
2031 
2047 



Appendix II: Hexadecimal -Decimal Conversion Table 385: 



/f ^\ 





x « 


1 


2 


3 


4 


5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


80x 
81x 
82x 
83x 


2048 
2064 
2080 
2096 


2049 
2065 
2081 
2097 


2050 
2066 
2082 
2098 


2051 
2067 
2083 
2099 


2052 
2068 
2084 
2100 


2053 
2069 
2085 
2101 


2054 
2070 
2086 
2102 


2055 
2071 
2087 
2103 


2056 
2072 
2088 
2104 


2057 
2073 
2089 
2105 


2058 
2074 
2090 
2106 


2059 
2075 
2091 
2107 


2060 
2076 
2092 
2108 


2061 
2077 
2093 
2109 


2062 
2078 
2094 
2110 


2063 
2079 
2095 
2111 


84x 
85x 
86x 
87x 


2112 
2128 
2144 
2160 


2113 
2129 
2145 
2161 


2114 
2130 
2146 
2162 


2115 
2131 
2147 
2163 


2116 
2132 

2148 
2164 


2117 
2133 
2149 
2165 


2118 
2134 
2150 
2166 


2119 
2135 
2151 
2167 


2120 
2136 
2152 
2168 


2121 
2137 
2153 
2169 


2122 
2138 
2154 
2170 


2123 
2139 
2155 
2171 


2124 
2140 
2156 
2172 


2125 
2141 
2157 
2173 


2126 
2142 
2158 
2174 


2127 
2143 
2159 
2175 


88x 
89x 
8Ax 
8Bx 


2176 
2192 
2208 
2224 


2177 
2193 
2209 
2225 


2178 
2194 
2210 
2226 


2179 
2195 
2211 
2227 


2180 
2196 
2212 
2228 


2181 
2197 
2213 
2229 


2182 
2198 
2214 
2230 


2183 
2199 
2215 
2231 


2184 
2200 
2216 
2232 


2185 
2201 
2217 
2233 


2186 
2202 
2218 
2234 


2187 
2203 
2219 
2235 


2188 
2204 
2220 
2236 


2189 
2205 
2221 
2237 


2190 
2206 
2222 
2238 


2191 
2207 
2223 
2239 


8Cx 
8Dx 
8Ex 
8Fx 


2240 
2256 
2272 
2288 


2241 
2257 
2273 
2289 


2242 
2258 
2274 
2290 


2243 
2259 
2275 
2291 


2244 
2260 
2276 
2292 


2245 
2261 
2277 
2293 


2246 
2262 
2278 
2294 


2247 
2263 
2279 
2295 


2248 
2264 
2280 
2296 


2249 
2265 
2281 
2297 


2250 
2266 
2282 
2298 


2251 
2267 
2283 
2299 


2252 
2268 
2284 
2300 


2253 
2269 
2285 
2301 


2254 
2270 
2286 
2302 


2255 
2271 
2287 
2303 


90x 
91x 
92x 
93x 


2304 
2320 
2336 
2352 


2305 
2321 
2337 
2353 


2306 
2322 
2338 
2354 


2307 
2323 
2339 
2355 


2308 
2324 
2340 
2356 


2309 
2325 
2341 
2357 


2310 
2326 
2342 
2358 


2311 
2327 
2343 
2359 


2312 
2328 
2344 
2360 


2313 
2329 
2345 
2361 


2314 
2330 
2346 
2362 


2315 
2331 
2347 
2363 


2316 
2332 
2348 
2364 


2317 
2333 
2349 
2365 


2318 
2334 
2350 
2366 


2319 
2335 
2351 
2367 


94x 
95x 
96x 
97x 


2368 
2384 
2400 
2416 


2369 
2385 
2401 
2417 


2370 
2386 
2402 
2418 


2371 
2387 
2403 
2419 


2372 
2388 
2404 
2420 


2373 
2389 
2405 
2421 


2374 
2390 
2406 
2422 


2375 
2391 
2407 
2423 


2376 
2392 
2408 
2424 


2377 
2393 
2409 
2425 


2378 
2394 
2410 
2426 


2379 
2395 
2411 
2427 


2380 
2396 
2412 
2428 


2381 
2397 

2413 
2429 


2382 
2398 
2414 
2430 


2383 
2399 
2415 
2431 


98x 
99x 
9Ax 
9Bx 


2432 
2448 
2464 
2480 


2433 
2449 
2465 
2481 


2434 
2450 
2466 
2482 


2435 
2451 
2467 
2483 


2436 
2452 
2468 
2484 


2437 
2453 
2469 
2485 


2438 
2454 
2470 
2486 


2439 
2455 
2471 
2487 


2440 
2456 
2472 
2488 


2441 
2457 
2473 
2489 


2442 
2458 
2474 
2490 


2443 
2459 
2475 
2491 


2444 
2460 
2476 
2492 


2445 
2461 
2477 
2493 


2446 
2462 
2478 
2494 


2447 
2463 
2479 
2495 


9Cx 
9Dx 
9Ex 
9FX 


2496 
2512 
2528 

2544 


2497 
2513 
2529 

2545 


2498 
2514 
2530 
2546 


2499 
2515 
2531 
2547 


2500 
2516 
2532 
2548 


2501 
2517 
2533 
2549 


2502 
2518 
2534 
2550 


2503 
2519 
2535 
25S1 


2504 
2520 
2536 
2552 


250S 
2521 
2537 
2553 


2506 
2522 
2538 
2554 


2507 
2523 
2539 
2555 


2508 
2524 
2540 
2556 


2509 
2525 
2541 
2557 


2510 
2526 
2542 
2558 


2511 
2527 
2543 
2559 


AOx 
A1x 
A2x 
A3x 


2560 
2576 
2592 
2608 


2561 
2577 
2593 
2609 


2S62 
2578 
2594 
2610 


2563 
2579 
2595 
2611 


2564 
2580 
2596 
2612 


256S 
2581 
2597 
2613 


2S66 
2582 
2598 
2614 


2567 
2583 
2599 
2615 


2568 
2584 
2600 
2616 


2569 
2585 
2601 
2617 


2570 
2586 
2602 
2618 


2571 
2587 
2603 
2619 


2572 
2588 
2604 
2620 


2573 
2589 
2605 
2621 


2574 
2590 
2606 
2622 


2575 
2591 
2607 
2623 


A4x 
A5x 
A6x 
A7x 


2624 
2640 
2656 
2672 


2625 
2641 
2657 
2673 


2626 
2642 
2658 
2674 


2627 
2643 
2659 
2675 


2628 
2644 
2660 
2676 


2629 
2645 
2661 
2677 


2630 
2646 
2662 
2678 


2631 
2647 
2663 
2679 


2632 
2648 
2664 
2680 


2633 
2649 
266S 
2681 


2634 
2650 
2666 
2682 


2635 
2651 
2667 
2683 


2636 
2652 
2668 
2684 


2637 
2653 
2669 
2685 


2638 
2654 
2670 
2686 


2639 
2655 
2671 
2687 


A8x 
A9x 
AAx 
ABx 


2688 
2704 
2720 
2736 


2689 
2705 
2721 
2737 


2690 
2706 
2722 
2738 


2691 
2707 
2723 
2739 


2692 
2708 
2724 
2740 


2693 
2709 
2725 
2741 


2694 
2710 
2726 
2742 


2695 
2711 
2727 
2743 


2696 
2712 
2728 
2744 


2697 
2713 
2729 
2745 


2698 
2714 
2730 
2746 


2699 
2715 
2731 
2747 


2700 
2716 
2732 
2748 


2701 
2717 
2733 
2749 


2702 
2718 
2734 
2750 


2703 
2719 
2735 
2751 


ACx 
AOx 
AEx 
AFx 


2752 
2768 
2784 
2800 


2753 
2769 
2785 
2801 


2754 
2770 
2786 
2802 


2755 
2771 
2787 
2803 


2756 
2772 
2788 
2804 


2757 
2773 
2789 
2805 


2758 
2774 
2790 
2806 


2759 
2775 
2791 
2807 


2760 
2776 
2792 
2808 


2761 
2777 
2793 

2809 


2762 
2778 
2794 
2810 


2763 
2779 
2795 
2811 


276" 
2780 
2796 
2812 


,, 765 
2781 
2797 
2813 


2766 
2782 
2798 
2814 


2767 
2783 
2799 
2815 


BOx 
Blx 
B2x 
B3x 


2816 
2832 
2848 
2864 


281? 
2833 
2849 
2865 


2818 
2834 
2850 
2866 


2819 
2835 
2851 
2867 


2820 
2836 
2852 
2868 


2821 
2837 
2853 
2869 


2822 
2838 
2854 
2870 


2823 
2839 
2855 
2871 


2824 
2840 
2856 
2872 


2825 
2841 
2857 
2873 


2826 
2842 
2858 
2874 


2827 
2843 
2859 
2875 


2828 
2844 
2860 
2876 


2829 
2845 
2861 
2877 


2830 
2846 
2862 
2878 


2831 
2847 
2863 
2679 


B4x 
BSx 
B6x 
B7x 


2880 
2896 
2912 
2928 


2881 
2897 
2913 
2929 


2882 
2898 
2914 
2930 


2883 
2899 
2915 
2931 


2884 
2900 
2916 
2932 


2885 
2901 
2917 
2933 


2886 
2902 
2918 
2934 


2887 
2903 
2919 
2935 


2888 
2904 
2920 
29*36 


2889 
2905 
2921 
2937 


2890 
2906 
2922 
2938 


2891 
2907 
2923 
2939 


2892 
2908 
2924 
2940 


2893 
2909 
2925 
2941 


2894 
2910 
2926 
2942 


2895 
2911 
2927 
2943 


B8x 
B9X 
BAx 
BBx 


2944 
2960 
2976 
2992 


2945 
2961 
2977 
2993 


2946 
2962 
2978 

2994 


2947 
2963 
2979 
2995 


2948 
2964 
2980 
2996 


2949 
2965 
2981 
2997 


2950 
2966 
2982 
2998 


2951 
2967 
2983 
2999 


2952 
2968 
2984 
3000 


2953 
2969 
298S 
3001 


2954 
2970 
2986 
3002 


2955 
2971 
2987 
3003 


2956 
2972 
2988 
3004 


2957 
2973 
2989 
3005 


2958 
2974 
2990 
3006 


2959 
2975 
2991 
3007 


BCx 
BOx 
BEx 
BPx 


3008 
3024 
3040 
3056 


3009 
3025 
3041 
3057 


3010 
3026 
3042 
3058 


3011 
3027 
3043 
3059 


3012 
3028 
3044 
3060 


3013 
3029 
3045 
3061 


3014 
3030 
3046 
3062 


3015 
3031 
3047 
3063 


3016 

* 3032 

3048 

3064 


3017 
3033 
3049 
3065 


3018 
3034 
3050 
3066 


3019 
3035 
3051 
3067 


3020 
3036 
3052 
3068 


3021 
3037 
3053 
3069 


302.. 
3038 
3054 
3070 


3023 
3039 
3055 
3071 
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1 


2 


3 





5 


6 


7 


8 


9 


A 


B 


C 


D 


E 


F 


COx 
Clx 
C2x 
C3x 


3072 
3088 
3100 
3120 


3073 
3089 
3105 
3121 


3070 
3090 
3106 
3122 


3075 
3091 
3107 
3123 


3076 
3092 
3108 
3120 


3077 
3093 
3109 
3125 


3078 
3090 
3110 
3126 


3079 
3095 
3111 
3127 


3080 
3096 
3112 
3128 


3081 
3097 
3113 
3129 


3082 
3098 
3110 
3130 


3083 
3099 
3115 
3131 


3080 
3100 
3116 
3132 


JWOO 

3101 
3117 
3133 


3086 
3102 
3118 
3130 


3087 
3103 
3119 
3135 


COx 
C5x 
C6x 
C7x 


3136 
1152 
3168 
3180 


3137 
3153 
3169 
3185 


3138 
3150 
3170 
3186 


3139 
3155 
3171 
3187 


3100 
3156 
3172 
3188 


3101 
3157 
3173 
3189 


3102 
3158 
3170 
3190 


3103 
3159 
3175 
3191 


3100 
3160 
3176 
3192 


3105 
3161 
3177 
3193 


3106 
3162 
3178 
3190 


3107 
3163 
3179 
3195 


3108 
3160 
3180 
3196 


3109 
3165 
3181 
3197 


3150 
3166 
3182 
3198 


3151 
3167 
3183 
3199 


C8x 
C9x 
CAx 
CBx 


3200 
3216 
3232 
3208 


3201 
3217 
3233 
3209 


3202 
3218 
3230 
3250 


3203 
3219 
3235 
3251 


3200 
3220 
3236 
3252 


3205 
3221 
3237 
3253 


3206 
3222' 
3238 
3250 


3207 
3223 
3239 
3255 


3208 
3220 
3200 
3256 


3209 
3225 
3201 
3257 


3210 
3226 
3202 
3258 


3211 
3227 
3203 
3259 


3212 
3228 
3200 
3260 


3213 
3229 
3205 
3261 


3210 
3230 
3206 
3262 


3215 
3231 
3207 
3263 


CCx 
CDx 
CBx 
CFx 


3260 
3280 
3296 
3312 


3265 
3281 
3297 
3313 


3266 
3282 
3298 
3310 


3267 
3283 
3299 
3315 


3268 
3280 
3300 
3316 


3269 
3285 
3301 
3317 


3270 
3286 
3302 
3318 


3271 
3287 
3303 
3319 


3272 
3288 
3300 
3320 


3273 
3289 
3305 
3321 


3270 
3290 
3306 
3322 


3275 
3291 
3307 
3323 


3276 
3292 
3308 
3320 


3277 
3293 
3309 
3325 


3278 
3290 
3310 
3326 


3279 
3295 
3311 
3327 


DOx 
D1x 
D2x 
D3x 


3328 
3300 
3360 
3376 


3329 
3305 
3361 
3377 


3330 
3306 
3362 
3378 


3331 
3307 
3363 
3379 


3332 
3308 
3360 
3380 


3333 
3309 
3365 
3381 


3330 
3350 
3366 
3382 


3335 
33S1 
3367 
3383 


3336 
3352 
3368 

3380 


3337 
3353 
3369 
3385 


3338 
3350 
3370 
3386 


3339 
3355 
3371 
3387 


3300 
3356 
3372 
3388 


3301 
3357 
3373 
3389 


3302 
3358 
3370 
3390 


3303 
3359 
3375 
3391 


DOx 
D5x 
D6x 
D7x 


3392 

3008 
3020 
3000 


3393 
3009 
3025 
3001 


3390 
3010 
3026 
3002 


3395 
3011 
3027 
3003 


3396 
3012 
3028 
3000 


3397 
3013 
3029 
3005 


3398 
3010 
3030 
3006 


3399 
3015 
3031 
3007 


3000 
3016 
3032 
3008 


3001 
3017 
3033 
3009 


3002 
3018 
3030 
3050 


3003 
3019 
3035 
3051 


3000 
3020 
3036 
3052 


3005 
3021 
3037 
3053 


3006 
3022 
3038 
3050 


3007 
3023 
3039 
3055 


D8x 
D9x 
DAx 

DBx 


3056 
3072 
3088 
3500 


3057 
3073 
3089 
3505 


3058 
3070 
3090 
3506 


30 59 
30 75 
3091 
3507 


3060 
3076 
3092 
3508 


3061 
3077 
3093 
3509 


3062 
3078 
3090 
3510 


3063 
3079 
3095 
3511 


3060 
3080 
3096 
3512 


3065 
3081 
3097 
3513 


3066 
3082 
3098 
3510 


3067 
3083 
3099 
3515 


3068 
3080 
3500 
3516 


3069 
3085 
3501 
3517 


3070 
30 86 
3502 
3518 


3071 
3087 
3503 
3519 


DCx 

DDx 
DEx 
DFx 


3520 
3536 
3552 
3568 


3521 
3537 
3553 
3569 


3522 
3538 
3550 
3570 


3523 
3539 
3555 
3571 


3520 
3500 
3556 
3572 


3525 
3501 
3557 
3573 


3526 
3502 
3558 

3570 


3527 
3503 

3559 
3575 


3528 
3500 
3560 
3576 


3529 
3505 
3561 
3577 


3530 
3506 
3562 
3578 


3531 
3507 
3563 
3579 


3532 
3508 
3560 
3580 


3533 
3509 
3565 
3581 


3530 
3550 
3566 
3582 


3535 
3551 
3567 
3583 


EOx 
E1x 
E2x 
E3x 


3580 
3600 
3616 
3632 


3585 
3601 
3617 
3633 


3586 
3602 
3618 
3630 


3587 
3603 
3619 
3635 


3588 
3600 
3620 
3636 


3589 
360S 
3621 
3637 


3590 
3606 
3622 
3638 


3591 
3607 
3623 
3639 


3592 
3608 
3620 
3600 


3593 
3609 
3625 
3601 


3590 
3610 
3626 
3602 


3595 
3611 
3627 
3603 


3596 
3612 
3628 
3600 


3597 
3613 
3629 
3605 


3598 
3610 
3630 
3606 


3599 
3615 
3631 
3607 


EOx 
E5x 
E6x 
E7x 


3608 
3660 
3680 
3696 


3609 
3665 
3681 
3697 


3650 
3666 
3682 
3698 


3651 
3667 
3683 
3699 


3652 
3668 
3680 
3700 


3653 
3669 
3685 
3701 


3650 
3670 
3686 
3702 


3655 
3671 
3687 
3703 


36S6 
3672 
3688 
3700 


3657 
3673 
3689 
3705 


3658 
3670 
3690 
3706 


3659 
3675 
3691 
3707 


3660 
3676 
3692 
3708 


3661 
3677 
3693 
3709 


3662 
3678 
3690 
3710 


3663 
3679 
3695 
3711 


E8x 
E9x 
EAx 
EBx 


3712 
3728 
3700 
3760 


3713 
3729 
3705 
3761 


3710 
3730 
3706 
3762 


3715 
3731 
3707 
3763 


3716 
3732 
3708 
3760 


3717 
3733 
3709 
3765 


3718 
3730 
3750 
3766 


3719 
3735 
3751 
3767 


3720 
3736 
3752 
3768 


3721 
3737 
3753 
3769 


3722 
3738 
3750 
3770 


3723 
3739 
3755 
3771 


3720 
3700 
3756 
3772 


3725 
3701 
3757 
3773 


371b 
3702 
3758 
3770 


3727 
3703 
3759 
3775 


ECx 
EDx 
EEX 
EFx 


3776 
3792 
3808 
3820 


3777 
3793 
3809 
3825 


3778 
3790 
3810 
3826 


3779 
3795 
3811 
3827 


3780 
3796 
3812 
3828 


3781 
3797 
3813 
3829 


3782 
3798 
3810 
3830 


3783 
3799 
3815 
3831 


3780 
3800 
3816 
3832 


3785 
3801 
3817 
3833 


3786 
3802 
3818 
3830 


3787 
3803 
3819 
3835 


3788 
3800 
3820 
3836 


3789 
3805 
3821 
3837 


3790 
3806 
3822 
3838 


3791 
3807 
3823 
3839 


FOx 
Fix 
F2x 
F3x 


3800 
3856 
3872 
3888 


3801 
3857 
3873 
3889 


3802 
3858 
3870 
3890 


3803 
3859 
3875 
3891 


3800 
3860 
3876 
3892 


3805 
3861 
3877 
3893 


3806 
3862 
3878 
3890 


3807 
3863 
3879 
3895 


3808 
3860 
3880 
3896 


3809 
3865 
3881 
3697 


3850 
3866 
3882 
3898 


3851 
3867 
3883 
3899 


3352 
3868 
3880 
3900 


3853 
3869 
3885 
3901 


3850 
3870 
3886 
3902 


3855 
3871 
3887 
3903 


FOx 
F5x 
F6x 
F7x 


3900 
3920 
3936 
3952 


3905 
3921 
3937 
3953 


3906 
3922 
3938 
3950 


3907 
3923 
3939 
3955 


3908 
3920 
3900 
3956 


3909 
3925 
3901 
3957 


3910 
3926 
3902 
3958 


3911 
3927 
3903 
3959 


3912 
3928 
3900 
3960 


3913 
3929 
3905 
3961 


3910 
3930 
3906 
3962 


3915 
3931 
3907 
3963 


3916 
3932 
3908 
3960 


3917 
3933 
3909 
3965 


3918 
3930 
3950 
3966 


3919 
3935 
3951 
3967 


F8x 
F9x 

* FAX 

FBx 


3968 
3980 
0000 
0016 


3969 
3985 
0001 
0017 


3970 
3986 
0002 
0018 


3971 
3987 
0003 
0019 


3972 
3988 
0000 
0020 


3973 
3989 
0005 
0021 


3970 
3990 
0006 
0022 


3975 
3991 
0007 
0023 


3976 
3992 

0008 
0020 


3977 
3993 
0009 
4025 


3978 
3990 
0010 
0026 


3979 
3995 
0011 
0027 


3980 
3996 
0012 
0028 


3981 
3997 
0013 
0029 


3982 
3998 
0010 
0030 


3983 
3999 
0015 
0031 


FCx 
FDx 
FEx 
FFx 


0032 
0008 
0060 
0080 


0033 
0009 
0065 
0081 


0030 
0050 
0066 
0082 


0035 
0051 
0067 
0083 


0036 
0052 
0068 
0080 


0037 
0053 
0069 
0085 


0038 
0050 
0070 
0086 


0039 
0055 
0071 
0087 


0000 
0056 
0072 
0088 


0001 
0057 
0073 
0089 


0002 
0058 
0070 
0090 


0003 
0059 
0075 
0091 


0000 
0060 
0076 
0092 


0005 
0061 
0077 
0093 


0006 
0062 
0078 
0090 


0007 
0063 
0079 
0095 
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Appendix III: Machine Instruction Format 



BASIC MACHINE FORMAT 



ASSEMBLER OPERAND 
FIELD FORMAT 



APPLICABLE INSTRUCTIONS 



RR 



8 

Operation 

Code 


4 
Rl 


4 
R2 




8 

Operation 
Code 


4 

Ml 


4 
R2 




8 

Operation 

Code 


4 
Rl 






8 

Operation 

Code 


8 

I 



R1,R2 



M1,R2 



Rl 



(See Notes 1,6,8, 
and 9) 



All RR instructions 
except BCR,SPM, 
and SVC 



BCR 



SPM 



SVC 



RX 



8 

Operation 

Code 


4 
Rl 


4 
X2 


4 
B2 


12 

D2 




8 

Operation 

Code 


4 
Ml 


4 
X2 


4 
B2 


12 
D2 



R1,D2(X2,B2) 
R1,D2(,B2) 
R1,S2(X2) 
R1,S2 



M1,D2(X2,B2) 
M1,D2(,B2) 
M1,S2(X2) 
M1,S2 

(See Notes 1,6,8, 
and 9) 



All RX instructions 
except BC 



BC 



RS 



8 


4 


4 


4 


12 


Operation 
Code 


Rl 


R3 


B2 


D2 



8 


4 


4 


4 


12 


Operation 










Code 


Rl 




B2 


D2 



8 


4 


4 


4 


12 


Operation 
Code 


Rl 


M3 


B2 


D2 



R1,R3,D2(B2) 
R1,R3',S2 



R1,D2(B2) 
R1,S2 



R1,M3,D2(B2) 
R1,M3,S2 

(See Notes 1-3,7, 
8, and 9) 



BXH,BXLE,CDS,CS,LM,SIGP, 
STM,LCTL,STCTL 



All shift instructions 



ICM,STCM,CLM 
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SI 



ss 



BASIC MACHINE FORMAT 



8 

Operation 
Code 


8 
12 


4 
Bl 


12 
Dl 



8 

Operation 

Code 




4 
Bl 


12 
Dl 



16 
Two-byte 
Operation 
Code 



Bl 



12 



Dl 



8 


4 


4 


4 


12 


4 


12 


Operation 














Code 


LI 


L2 


Bl 


Dl 


B2 


D2 



8 


8 


4 


12 


4 


12 


Operation 












Code 


L 


Bl 


Dl 


B2 


D2 



8 


4 


4 


4 


12 


4 


12 


Operation 














Code 


LI 


13 


Bl 


Dl 


B2 


D2 



ASSEMBLER OPERAND 
FIELD FORMAT 



D1(B1J,I2 
SI, 12 



D1(B1) 
SI 

(See Notes 2,3,6, 

7,8 and 10) 



D1(B1) 
SI 



(See Notes 2, 
3, and 7) 



D1(L1,B1) ,D2(L2,B2) 
S1(L1) ,S2(L2) 



D1(L,B1) ,D2(B2) 
S1(L) ,S2 



D1(L1,B1) ,D2(B2) ,13 
S1(L1) ,S2, 13 
S1,S2,I3 

(See Notes 2,3,5,6, 
7 and 10) 



APPLICABLE INSTRUCTIONS 



All SI instructions except 
those listed for the other 
SI format. 



LPSW , SSM , TIO , TCH , TS 



SCK,STCK,STIDP,SIOF,STIDC, 

SIO,HIO,HDV 

SCKC , STCKC , SPT , STPT , PTLB , 

RRB 

CLRIO , IPK , SPKA , SPX , STAP , 
STPX 



PACK,UNPK,MVO,AP, 
CP,DP,MP,SP,ZAP 



NC ,OC ,XC ,CLC ,MVC ,MVN, 
MVZ , TR , TRT , ED , EDMK 



SRP 



Notes for Appendix III: 

1. Rl, R2, and R3 are absolute expressions that specify general or floating-point reg- 
isters. The general register numbers are through 15; floating-point register num- 
bers are , 2 , 4 , and 6 . 



2. Dl and D2 are absolute expressions that specify displacements, 
may be specified. 

3. Bl and B2 are absolute expressions that specify base registers, 
- 15. 



A value of - 4095 



Register numbers are 



4. X2 is an absolute expression that specifies an index register. Register numbers are 
0-15. 

5. L, Ll, and L2 are absolute expressions that specify field lengths. An L expression 
can specify a value of 1 - 256. Ll and L2 expressions can specify a value of 1 - 16. 
In all cases, the assembled value will be one less than the specified value. 

6. I, 12, and 13 are absolute expressions that provide immediate data. The value of I 
and 12 may be - 255. The value of 13 may be - 9. 

7. SI and S2 are absolute or relocatable expressions that specify an address. 

8. RR, RS, and SI instruction fields that are blank under BASIC MACHINE FORMAT are not 
examined during instruction execution. The fields are not written in the symbolic 
operand, but are assembled as binary zeros. 

9. Ml and M3 specify a 4-bit mask. 

10. In IBM System/370 the SIO, HIO, HDV and SIOF operation codes occupy one byte and the 
low order bit of the second byte. In all other systems the HIO and SIO operation 
codes occupy only the first byte of the instruction. 
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Appendix IV, pages 391-4 06, has been 
removed. The following manuals are 
the definitive publications for 
machine instructions: 

IBM System/370 Principles of 
Operation 

IBM 4300 Processors Principles of 
Operation for ECPS;VSE Mode 






o 



t 



V*' 






up 



391-406 
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Appendix IV: Machine Instruction Mnemonic Codes 



This appendix contains two tables of the mnemonic operation codes for all machine 
instructions that can be represented in assembler language , including extended mnemonic 
operation codes. 

The first table is in alphabetic order by instruction. The second table is in numeric 
order by operation code. 4 

In the first table is indicated: both the mnemonic and machine operation codes, explicit 
and implicit operand formats, program interruptions possible, and condition code set. 

The column headings in the first table and the information each column provides follow: 

Instruction : This column contains the name of the instruction associated with the 
mnemonic operation code. 

Mnemonic Operation Code : This column contains the mnemonic operation code for the 
instruction. This is written in the operation field when coding the instruction. 

Machine Operation Code : This column contains the hexadecimal equivalent of the actual 
machine operation code. The operation code will apppear in this form in most storage 
dumps and when displayed on the system control panel. For extended mnemonics, this 
column also contains the mnemonic code of the instruction from which the extended 
mnemonic is derived. 

Operand Format : This column shows the symbolic format of the operand field in both 
explicit and implicit form. For both forms, R1, R2, and R3 indicate general registers in 
operand one, two, and three respectively. X2 indicates a general register used as an 
index register in the second operand. Instructions which require an index register (X2) 
but are not to be indexed are shown with a replacing X2. L, L1, and L2 indicate 
lengths for either operand, operand one, or operand two respectively. M1 and M3 indicate 
a 4-bit mask in operands one and three respectively. I, 12, and 13 indicate immediate 
data eight bits long (I and 12) or four bits long (13) . 

For the explicit format, D1 and D2 indicate a displacement and B1 and B2 indicate a base 
register for operands one and two. 

For the implicit format, D1 , B1, and D2, B2 are replaced by S1, and S2 which indicate a 
storage address in operands one and two. 

T ype of Instruction : This column gives the basic machine format of the instruction (RR, 
RX, SI, or SS) . If an instruction is included in a special feature or is an extended 
mnemonic, this is also indicated. 

Program Interruptions Possible : This column indicates the possible program interruptions 
for this instruction. The abreviations used are: A - Addressing, S - Specification, Ov - 
Overflow, P - Protection, Op - Operation (if feature is not installed) , and Other - other 
interruptions which are listed. The type of overflow is indicated by: D - Decimal, E - 
Exponent, or F - Fixed Point. 

Condition code set : The condition codes set as a result of this instruction are indicated 
in this column. (See legend following the table.) 
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|DOS/VSEonly 



Instruction 


Mnemonic 


Machine 


Operand Format 




Operation 


Operation 








Code 


Code 


Explicit 


Implicit 


Add 


A 


5A 


Rl,D2(X2,B2)orRl, D2(,B2) 


Rl,S2(X2)orRl,S2 


Add 


AR 


1A 


R1,R2 




Add Decimal 


AP 


FA 


D1(L1,B1),D2(L2,B2) 


Sl(Ll),S2(L2)orSl,S2 


Add Holfword 


AH 


4A 


Rl,D2(X2,B2)orR1,D2(,B2) 


Rl,S2(X2)orRl,S2 


Add Logical 


AL 


5E 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Add Logical 


ALR 


IE 


R1,R2 




Add Normalized, Extended 


AXR 


36 


R1,R2 




Add Normalized, Long 


AD 


6A 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Add Normalized, Long 


ADR 


2A 


R1,R2 




Add Normalized, Short- 


AE 


7k 


Rl,D2(X2,B2)orRl / D2(,B2) 


Rl,S2(X2)orRl,S2 


Add Normalized, Short 


AER 


3A 


R1,R2 




Add Unnormalized,Long 


AW 


6E 


RI,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orR1,S2 


Add Unnormalized, Long 


AWR 


2E 


R1,R2 




Add Unnormalized, Short 


AU 


7E 


R1,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl / S2 


Add Unnormalized, Short 


AUR 


3E 


R1,R2 




And Logical 


N 


54 


Rl,D2(X2,B2)orRl,D2(,B2) 


RI,S2(X2)orRl,S2 


And Logical 


NC 


D4 


D1(L,B1),D2(B2) 


S1(L),S2 orSl,S2 


And Logical 


NR 


14 


R1,R2 




And Logical Immediate 


Nl 


94 


Dl(BI), 12 


SI, 12 


Branch and Link 
Branch and Link 


BAL 
BALR 


45 

05 


Rl,D2(X2,B2)orRl,D2(,B2) 
Rl,R2 


R1,S2(X2)orRl,S2 


Branch and Save 
Branch and Save 


BAS 
BASR 


4D 
0D 


R1,D2(X2,B2)orRl,D2(,B2) 
R1,R2 


Rl,S2(X2)orRl,S2 


Branch on Condition 


BC 


47 


Ml,D2(X2,B2)orMl,D2(,B2) 


Ml,S2(X2)orMl,S2 


Branch on Condition 


BCR 


07 


M1,R2 




Branch on Count 


BCT 


46 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


Branch on Count 


BCTR 


06 


R1,R2 




Branch on Equal 


BE 


47(BC 8) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Equal 


BER 


07 (BCR 8) 


R2 




Branch on High 


BH 


47(BC 2) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on High 


BHR 


07(BCR 2) 


R2 




Branch on Index High 


BXH 


86 


R1,R3,D2(B2) 


R1,R3,S2 


Branch on Index Low or Equal 


BXLE 


87 


R1,R3,D2(B2) 


R1,R3,S2 


Branch on Low 


BL 


47(BC 4) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Low 


BLR 


07(BCR 4) 


R2 




Branch if Mixed 


BM 


47(BC 4) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch if Mixed 


BMR 


07(BCR 4) 


R2 




Branch on Minus 


BM 


47(BC 4) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Minus 


BMR 


07(BCR 4) 


R2 




Branch on Not Equal 


BNE 


47(BC7) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Not Equal 


BNER 


07(BCR 7) 


R2 




Branch on Not High 


BNH 


47 (BC 13) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Not High 


BNHR 


07(BCR 13) 


R2 




Branch on Not Low 


BNL 


47(BC 11) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Not Low 


BNLR 


07 (BCR 11) 


R2 




Branch if Not Mixed 


BNM 


47(BC 11) 


D2(X2,B2) or D2(,B2) 


S2(X2) or S2 


Branch if Not Mixed 


BNMR 


07(BCR 11) 


R2 




Branch on Not Minus 


BNM 


47 (BC 11) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Not Minus 


BNMR 


07 (BCR 11) 


R2 




Branch if Not Ones 


BNO 


47(BC 14) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch if Not Ones 


BNOR 


07(BCR 14) 


R2 




Branch on No Overflow 


BNO 


47(BC 14) 


D2(X2,B2) or D2(,B2) 


S2(X2) or S2 


Branch on No Overflow 


BNOR 


07(BCR 141 


R2 




Branch on Not Plus 


BNP 


47(BC 13) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Not Plus 


BNPR 


07(BCR 13) 


R2 




Branch if Not Zeros 


BNZ 


47(BC 7) 


D2(X2,B2) or D2(,B2) 


S2(X2) or S2 


Branch if Not Zeros 


BNZR 


07(BCR 7) 


R2 




Branch on Not Zero 


BNZ 


47(BC 7) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Not Zero 


BNZR 


07(BCR 7) 


R2 




Branch if Ones 


BO 


47(BC 1) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch if Ones 


BOR 


07(BCR 1) 


R2 




Branch on Overflow 


BO 


47(BC 1) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Overflow 


BOR 


07(BCR 1) 


R2 




Branch on Plus 


BP 


47(BC 2) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Plus 


BPR 


07(BCR 2) 


R2 




Branch if Zeros 


BZ 


47(BC 8) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch if Zeros 


BZR 


07(BCR 8) 


R2 




Branch on Zero 


BZ 


47(BC 8) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch on Zero 


BZR 


07(BCR 8) 


R2 




Branch Unconditional 


B 


47 (BC 15) 


D2(X2,B2)orD2(,B2) 


S2(X2) or S2 


Branch Unconditional 


BR 


07(BCR 15) 


R2 




Clear 1 /O 


CLRIO 


9D01 


D2(B2) 


S2 


Clear Storage Pag* 


CU8» 


B215 


P2(B2) 


S2 


Compare Algebraic 


C 


59 


Rl,D2(X2,B2)orR1,D2(,B2) 


Rl,S2(X2orRl,S2 


Compare Algebraic 


CR 


19 


R1,R2 




Compare and Swap 


CS 


BA 


R1,R3,D2,(B2) 


R1,R3,S2 


Compare Decimal 


CP 


F9 


D1(L1,B1),D2(L2,B2) 


Sia.l),S2(L2)orSl,S2 


Compare Double and Swap 


CDS 


BB 


R1,R3,D2(B2) 


R1,R3,S2 


Compare Halfword 


CH 


49 


Rl,D2(X2,B2)orRl ; D2(,B2) 


Rl,S2(X2)orRl,S2 


Compare Logical 


CL 


55 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl / S2 


Compare Logical 


CLC 


D5 


D1(L,B1),D2(B2) 


S1(L),S2 orSl,S2 



V^#/ 



392 









loOS/VSEonfy 







Program Interruption 










Instruction 


Type of 


Possible 




Condition Code Set 






Instruction 
Instruction 












A 


S 


Ov 


P 


Op 


Other 


00 


01 


10 


11 


Add 


RX 


x 


X 


F 








Sum=0 


Sum<0 


Sum>0 


Overflow 


Add 


RR 






F 








Sum=0 


Sum<0 


Sum>0 


Overflow 


Add Decimal 


SS, Decimal 


X 




D 


X 


X 


Data 


Sum=0 


Sum<0 


Sum>0 


Overflow 


Add Halfword 


RX 


X 


x 


F 








Sum=0 


Sum<0 


Sum>0 


Overflow 


Add Logical 


RX 


X 


X 










Sum=0® 


Sum 0© 


Sum= 0© 


Sum 0© 


Add Logical 


RR 














Sum-"0 ® 


Sum= 0® 


Sum= 0© 


Sum 0© 


Add Normalized, Extended 


RR,Floating Pt. 




X 


E 




X 


B,C 


R 




M 




Add Normalized, Long 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 




M 




Add Normalized, Long 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 




M 




Add Normalized, Short 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 




M 




Add Normalized, Short 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 




M 




Add Unnormalized,Long 


RX, Floating Pt. 


X 


x 


E 




X 


C 


R 




M 




Add Unnormalized, Long 


RR,Floating Pt. 




X 


E 




X 


C 


R 




M 




Add Unnormalized, Short 


RX, Floating Pt. 


X 


X 


E 




X 


C 


R 




M 




Add Unnormalized, Short 


RR, Floating Pt. 




X 


E 




X 


C 


R 




M 




And Logical 


RX 


X 


X 










J 


K 






And Logical 


SS 


X 






X 






J 


K 






And Logical 


RR 














J 


K 






And Logical Immediate 


SI 


x 






* 






J 


K 






Branch and Link 


RX 














N 


N 


N 


N 


Branch and Link 


RR 














N 


N 


N 


N 


Branch and Save 


RX 










X 




N 


N 


N 


N 


Branch and Save 


RR 










X 




N 


N 


N 


N 


Branch on Condition 


RX 














N 


N 


N 


N 


Branch on Condition 


RR 














N 


N 


N 


N 


Branch on Count 


RX 














N 


N 


N 


N 


Branch on Count 


RR 














N 


N 


N 


N 


Branch on Equal 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Equal 


RR,Ext.Mnemonic 














N 


N 


N 


N 


Branch on High 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on High 


RR, Ext .Mnemonic 














N 


N 


N 


N 


Branch on Index High 


RS 














N 


N 


N 


N 


Branch on Index Low or Equal 


RS 














N 


N 


N 


N 


Branch on Low 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Low 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Mixed 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Mixed 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Minus 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Minus 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not Equal 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not Equal 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not High 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not High 


RR, Ext .Mnemonic 














N 


N 


N 


N 


Branch on Not Low 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not Low 


RR, Ext .Mnemonic 














N 


N 


N 


N 


Branch it Not Mixed 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Not Mixed 


RR,Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Minus 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not Minus 


RR, Ext .Mnemonic 














N 


N 


N 


N 


Branch if Not Ones 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Not Ones 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch on No Overflow 


RX.Ext.Mnemonic 














N 


N 


N 


N 


Branch on No Overflow 


RR.Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Plus 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not Plus 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Not Zeros 


RX.Ext.Mnemonic 














N 


N 


N 


N 


Branch if Not Zeros 


RR.Ext.Mnemonic 














N 


N 


N 


N 


Branch on Not Zeros 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Not Zeros 


RR, Ext .Mnemonic 














N 


N 


N 


N 


Branch if Ones 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Ones 


RR, Ext . Mnemon i c 














N 


N 


N 


N 


Branch on Overflow 


RX, Ext. Mnemonic 














N 


N 


N 


1M 


Branch on Overflow 


RR.Ext.Mnemonic 














N 


N 


N 


N 


Branch on Plus 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Plus 


RR, Ext . Mnemon ic 














N 


N 


N 


N 


Branch if Zeros 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch if Zeros 


RR, Ext .Mnemonic 














N 


N 


N 


N 


Branch on Zero 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch on Zero 


RR, Ext. Mnemonic 














N 


N 


N 


N 


Branch Unconditional 


RX, Ext. Mnemonic 














N 


N 


N 


N 


Branch Unconditional 


RR, Ext . Mnemon ic 














N 


N 


N 


N 


Clear I/O 

Clear Sroroae Page 


S 












A 


AAX 


CC 


EE 


KK 


s 


K 






k :. 




A,GB 










Compare Algebraic 


RX 


X 


X 










Z 


AA 


BB 




Compare Algebraic 


RR 














z 


AA 


BB 




Compare and Swap 


RS 


X 


X 




X 


X 




z 


AAW 






Compare Decimal 


SS, Decimal 


X 








X 


Data 


z 


AA 


BB 




Compare Double and Swap 


RS 


X 


X 




X 


X 




z 


AAW 






Compare Halfword 


RX 


X 


X 










z 


AA 


BB 




Compare Logical 


RX 


X 


X 










z 


AA 


BB 




Compare Logical 


SS 


X 


X 










z 


AA 


BB 
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Instruction 


Mnemonic 
Operation 


Machine 
Operation 


Operand Format 






Code 


Code 


Explicit 


Implicit 




Compare Logical 


CLR 


15 


R1,R2 






Compare Logical Characters 


CLM 


BD 


R1,M3,D2(B2) 


R1,M3,S2 




under Mask 












Compare Logical Immediate 


CLI 


95 


Dl(Bl),l2 


SI, 12 




Compare Logical Long 


CLCL 


OF 


R1,R2 






Compare, Long 


CD 


69 


Rl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 




Compare, Long 


CDR 


29 


*1,R2 






Compare, Short 


CE 


79 


Kl,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 




Compare, Short 


CER 


39 


U,R2 




|DOS/VSEonty 


Connect Page 


CTF 


SO 


R,D2<62r 


*1>S2 




Convert to Binory 


CVB 


4F 


*l,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 




Convert to Decimal 


CVD 


4E 


»l,D2(X2,B2)orRl,D2(,B2) 


Rl,S2(X2)orRl,S2 


|0OS/VS€onlv 
iDOS/VSEonly 


Decanfigure Pag* 


06* 


S2tl 


D2(B2) 


S2 V 


Oiscormect Page 


Dorr 


wnc 


tarn 


'»-■■:■■ 




Divide 


D 


5D 


M,D2(x2,B2)orRl,D2(,B2) 


R1, S2(X2) orRl,S2 




Divide 


DR 


ID 


K1,R2 






Divide Decimal 


DP 


FD 


D1,(L1,B1),D2(L2,B2) 


Sl(Ll),S2(L2)or S1,S2 




Divide, Long 


DD 


6D 


Rl,D2(X2,B2),orRl,D2(,B2) 


R1,S2(X2) orRl,S2 




Divide, Long 


DDR 


2D 


R1,R2 






Divide, Short 


DE 


70 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 




Divide, Short 


DER 


3D 


R1,R2 






Edit 


ED 


DE 


D1(L,B1),D2(B2) 


S1(L),S2 orSl,S2 




Edit and Mark 


EDMK 


DF 


D1(L,B1),D2(B2) 


S1(L),S2 orSl,S2 




Exclusive Or 


X 


57 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 




Exclusive Or 


xc 


D7 


DI(L,B1),D2(B2) 


S1(L),S2 orSI,S2 




Exclusive Or 


XR 


17 


R1,R2 






Exclusive Or Immediate 


XI 


97 


DI(B1), 12 


SI, 12 




Execute 


EX 


44 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) R1,S2 




Halve, Long 


HDR 


24 


R1,R2 






Halve, Short 


HER 


34 


R1,R2 






Halt Device 


HDV 


9E01 1 


D1,B1 


SI 




Halt I/O 


HIO 


9E00 1 


D1(B1) 




|DOS/VSEonl V 


Insert Peat: Wkm" 


m 


84 


M, DC Oft" 


R1,S2 




Insert Character 


IC 


43 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 




Insert Characters under Mask 


ICM 


BF 


R1,M3,D2(B2) 


R1,M3,S2 




Insert PSW Key 


IPK 


B20B 








Insert Storage Key 


ISK 


09 


R1,R2 






Load 


L 


58 


Rl,D2(X2,B2)orRI,D2(,B2) 


R1,S2(X2) orRl,S2 




Load 


LR 


18 


R1,R2 






Load Address 


LA 


41 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orR1,S2 




Load and Test 


LTR 


12 


R1,R2 






Load and Test, Long 


LTDR 


22 


R1,R2 






Load and Test, Short 


LTER 


32 


R1,R2 






Load Complement 


LCR 


13 


RI,R2 






Load Complement, Long 


LCDR 


23 


R1,R2 






Load Complement, Short 


LCER 


33 


R1,R2 






Load Control 


LCTL 


B7 


R1,R3,D2(B2) 


R1,R3,S2 


| OOS/VSC only 


Load Frame Index 


W 


ftft 


R1,D2»# 


Ri,S2 




Load Halfword 


LH 


48 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 




Load, Long 


LD 


68 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 




Load, Long 


LDR 


28 


R1,R2 






Load Multiple 


LM 


98 


R1,R3,D2(B2) 


R1,R3,S2 




Load Negative 


LNR 


11 


R1,R2 






Load Negative, Long 


LNDR 


21 


R1,R2 






Load Negative, Short 


LNER 


31 


R1,R2 






Load Positive 


LPR 


10 


R1,R2 






Load Positive, Long 


LPDR 


20 


R1,R2 






Load Positive, Short 


LPER 


30 


R1,R2 






Load PSW 


LPSW 


82 


D1(B1) 


SI 


|NotDOS/VSE 


Load Rttl Addres* 


LRA 


81 


R»,£>2<X2,82)orM,D2<,B2) 


Rl,S2(X2)orRl,S2 




Load Rounded, Extended 


LRDR 


25 


R1,R2 






to Long 






, 






Load Rounded, Long to Short 


LRER 


35 


R1,R2 






Load, Short 


LE 


78 


R1,D2(X2,B2) or R1,D2(,B2) 


R1,S2(X2) orRl,S2 




Load, Short 


LER 


38 


R1.R2 




IDOS/VSEonly 
|008/VSEonJy 


Make Addressable 


MAO 


B210 


mm 


& ■'■'■■■ 


Make UrwddreseobU 


MUN 


B21E 


mm 


u 




Monitor Call 


MC 


AF 


DlAl),l2 
D1<L,B1),D2(B2) 


51,12 




Move Characters 


MVC 


D2 


S1(L),S2 orSI,S2 ' 
SI, 12 




Move Immediate 


MVI 


92 


D1(B1), 12 






See Note 1 at end of 
this appendix 



X, 



■^ 



9 
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\\ 




Type of 
Instruction 


Program Interrupt 


ions 










p 


Instruction 


Posi 


llW« 






Condition Code Set 




w 


A 


S 


Ov 


P 


Op 


Other 


00 


01 


10 


11 




Compare Logical 


RR 


X 












z 


AA 


BB 






Compart Logical Characters 


RS 


X 






X 


X 




XX 


YY 


zz 






under Mask 


























Compare Logical Immediate 


SI 


X 












z 


AA 


BB 






Compare Logical Long 


RR 


X 


X 




X 


X 




z 


AA 


BB 






Compare, Long 


RX, Floating Pt. 


X 


X 






X 




z 


AA 


BB 






Compare, Long 


RR, Floating Pt. 


X 


X 






X 




z 


AA 


BB 






Compare, Short 


RX, Floating Pt. 


X 


X 






X 




z 


AA 


BB 






Compare, Short 


RR, Floating Pt. 




X 






X 


, 


z 


AA 


BB 




| &0S/V8E onty 


fCwnwwt A»g* 


KS 


* 


X 






:* 


A,OC 


ABA '■: 


■:..::<m ° 


' ; -Aie ' 






Convert to Binary 


RX 


X 


X 








Dato,F 


N 


N 


N 


N 




Convert to Decimal 


RX 


X 


X 




X 






N 


N 


N 


N 


iDOS/vseoniv 

1 OOS/VSE only 


Deconftgure Page 


$ 


"*; 


» 






.',* 


A t ec 










Disconnect tog* 


S 


X 


* 






. X. 


A,©C 


AM 


'■'"'' Aftf 








Divide 


RX 


X 


X 








F 


N 


N 


N 


N 




Divide 


RR 




X 








F 


N 


N 


N 


N 




Divide Decimal 


SS, Decimal 


X 


X 




X 


X 


D, Data 


N 


N 


N 


N 




Divide, Long 


RX,Floating Pt. 


X 


X 


E 




X 


B,E 


N 


N 


N 


N 




Divide, Long 


RR, Floating Pt. 




X 


E 




X 


B,E 


N 


N 


N 


N 




Divide, Short 


RX, Floating Pt. 


X' 


X 


E 




X 


B,E 


N 


N 


N 


N 




Divide, Short 


RR, Floating Pt. 




X 


E 




X 


B,E 


N 


N 


N 


N 




Edit 


SS, Decimal 


X 






X 


X 


Data 


S 


T 


U 






Edit and Mark 


SS, Decimal 


X 






X 


X 


Data 


S 


T 


U 






Exclusive Or 


RX 


X 


X 










J 


K 








Exclusive Or 


SS 


X 






X 






J 


K 








Exclusive Or 


RR 














J 


K 








Exclusive Or Immediate 


SI 


X 






X 






J 


K 








Execute 


RX 


X 


X 








G 


(Maybe 


set by this instruction) 






Halve, Long 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 




Halve, Short 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 




Halt Device 


S 












A 


AAM 


CC 


AAL 






Halt I/O 


S 












A 


DD 


CC 


GG 


KK 


1 DOS/V8€on»y 


Insert Page Bits 


*s 


X 








X 


A 








■ 




Insert Character 


RX 


X 












N 


N 


N 


N 


w. 


Insert Characters under Mask 


RS 


X 






X 


X 




UU 


TT 


SS 




T\ 


Insert PSW Key 


S 










X 


A 










J 


Insert Storage Key 


RR 


X 


X 






X 


A 


N 


N 


N 


N 




Load 


RX 


X 


X 










N 


N 


N 


N 




Load 


RR 














N 


N 


N 


N 




Load Address 


RX 














N 


N 


N 


N 




Load and Test 


RR 














J 


L 


M 






Load and Test, Long 


RR, Floating Pt. 




X 






X 




R 


L 


M 






Load and Test, Short 


RR, Floating Pt. 




X 






X 




R 


L 


M 






Load Complement 


RR 






F 








P 


L 


M 







Load Complement, Long 


RR, Floating Pt. 




X 






X 




R 


L 


M 






Load Complement, Short 


RR, Floating Pt. 




X 






X 




R 


L 


M 






Load Control 


RS 


X 


X 




X 


X 


A 


N 


N 


N 


N 


|D06/VS£on*y 


Load Frame Index 


RS 










X 


A 


mr 


A1G 


ABH 


AJM 




Load Holfword 


RX 


X 


x 










N 


N 


N 


N 




Load, Long 


RX, Floating Pt. 


X 


X 






X 




N 


N 


N 


N 




Load, Long 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 




Load Multiple 


RS 


X 


X 










N 


N 


N 


N 




Load Negative 


RR 














J 


L 








Load Negative, Long. 


RR, Floating Pt. 




X 






X 




R 


L 








Load Negative, Short 


RR, Floating Pt. 




X 






X 




R 


L 








Load Positive 


RR 






F 








J 




M 


O 




Load Positive, Long 


RR, Floating Pt. 




X 






X 




R 


L 


M 






Load Positive, Short 


RR, Floating Pt. 




X 






X 




R 


L 


M 






Load PSW 


SI 


X 


X 








A 


QQ 


QQ 


QQ 


QQ 


| N#tt)Q3/VS£ 


load Real Address ' 


JtX 


X 


X 






X 


A 


AAV 


; -AAM--* 


; '*AP,..: 


AAO 




load Rounded, Extended 


RR, Floating Pt. 




X 


E 




X 




N 


H 


N 


N 




to Long 


























Load Rounded, Long to Short 


RR, Floating Pt. 




X 


E 




X 




N 


N 


N 


N 




Load, Short 


RX, Floating Pt. 


X 


X 






X 




N 


N 


N 


N 




Load, Short 


RR, Floating Pt. 




X 






X 




N 


N 


N 


N 


1 ©QiifVSE only 


Moke Addressable 


;* ■';■'■■■ 


X 








* 


A,OC 


AC* 


AW 






\ Make Urwddrstaoble 


$ 


X 


X 




f 1 


■X 


A,GC 


AUC 


Ail 








Move Characters 


SS 


X 






X 






N 


N 


N 


N 




Move Immediate 


SI 


X 






X 






N 


N 


N 


N 



Appendix IV: Machine Instruction Mnemonic Operation Codes 395 







Mnemonic 


Machine 


Operand Format 




Instruction 


Operation 
Code 


Operation 
Code 


Explicit 


Implicit 




Move Long 


MVCL 


OF 


P.I,R2 






Move Numerics 


MVN 


Dl 


D1(L,B1),D2(B2) 


S1(L),S2 orSl.H 




Move with Offset 


MVO 


F! 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2)orSl,S2 




Move Zones 


MVZ 


D3 


D1(L,B!),D2(B2) 


S1(L),S2 orS1,S2 




Multiply 


M 


5C 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orR1,S2 




Multiply 


MR 


1C 


R1,R2 






Multiply Decimal 


MP 


FC 


D1(L1,B1),D2(L2,B2) 


S1(L1),S2(L2)orSl,S2 




Multiply Extended 


MXR 


26 


R1,R2 






Multiply Holfword 


MH 


4C 


Rl,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) orRl,S2 




Multiply, Long 


MD 


6C 


Rl,D2(X2,B2)orRI,D2(,B2) 


R1,S2(X2) orR1,S2 




Multiply, Long 


MDR 


2C 


R1,R2 






Multiply. Long to 


MXD 


67 


Rl,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) orR1,S2 




ua renuvu 

Multiply, Long to 


MXDR 


27 


R1,R2 






Extended 












Multiply, Short 


ME 


7C 


R1,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) orR],S2 




Multiply, Short 


MER 


3C 


R1,R2 






No Operation 


NOP 


47(BC 0) 


D2(X2,B2)orD2(,82) 


S2(X2) orS2 




No Operation 


NO PR 


07(BC 0) 


R2 






Or Logical 


O 


56 


Rl,D2(X2,B2)orRl,D2(,B2) 
DI(L,B1),D2(B2) 


R1,S2(X2) orRl,S2 




Or Logical 


OC 


D6 


S1(L),S2 orSl,S2 




Or Logical 


OR 


16 


R1,R2 






Or Logical Immediate 


Ol 


96 


D1(B1),I2 
D1(L1,B1),D2(L2,B2) 


SI, 12 




Pack 


PACK 


F2 


Sl(L1),S2(L2)orS1,S2 




Purge Translation Lookaside 
Buffer 


PUB 


B20D 


„ 


_ 












| NotDOSWSE 


Read Direct 


ROD 


85 


DlflMhtt 
01(B1) 


SI, 12 




Reset Reference Bit 


RRB 


B213 


SI 


006/VSEonty 


Retrieve Status and Pag* 


RSP 


D8 


D1(,B1),D2(B2) 


SI,S2 










D1(B1),D2(B2) 




DOS/VS§onlv 


Set Page Bit* 


SPB 


B5 


R1,D2(B2) 


Rl7s2 




Set Clock 


SCK 


B204 


DI(B1) 


SI 




Set Clock Comparator 


SCKC 


B206 


D1(B1 
D1(B1) 


SI 




Set CPU Timer 


SPT 


B208 


SI 




Set Prefix 


SPX 


B210 


D2(B2) 


S2 




Set Program Mask 


SPM 


04 


R1 






Set PSW Key from Address 


SPKA 


B20A 


D,(B,) 


SI 




Set Storage Key 


SSK 


08 


R1,R2 






Set System Mask 


SSM 


80 


DI(BI) 


SI 




Shift and Round Decimal 


SRP 


F0 


D1(L1,B1),D2(B2),I3 


Sl(L1),S2,l3orSI,S2,l3 




Shift Left Double Algebraic 


SLDA 


8F 


R1,D2(B2) 


R1,S2 




Shift Left Double Logical 


SLDL 


8D 


RI,D2(B2) 


R1 S2 




Shift Left Single Algebraic 


SLA 


8B 


R1,D2(B2) 
R1,D2(B2) 


Rl'S2 




Shift Left Single Logical 
Shift Right Double Algebraic 


SLL 


8? 


R1 S2 




SRDA 


8E 


R1,D2(B2) 
R1,D2(B2) 


R1S2 




Shift Right Double Logical 


SRDL 


8C 


R1^S2 




Shift Right Single Algebraic 


SRA 


8A 


R1,D2(B2) 
R1,D2(B2) 


R1,S2 
R1,S2 




Shift Right Single Logical 


SRL 


88 




Signal Processor 


SIGP 


AE 


R1,R3,D2(B2) 


R1,R3,S2 ' 




Start I/O 

Start I/O Fast Release 


SIO 
SIOF 


9COo! 
9C01 1 


D1(B1) 
DI(BI) 


SI 
SI 


I DOS/VSE on*y 


Store 

Store Capacity Count* 


ST 
STCAP 


50 


RI,D2(X2,B2)orRl,D2(,B2) 

mm ■ ;• i-^if ■■:■■ 

D1(Bll 


R1,S2(X2) orRl,S2 
S2 

si 




Store Channel ID 


ST IDC 


B203 




Store Character 


STC 


42 


R1,D2(X2,B2)orRl,D2(,B2) 


R1,D2(X2) orR1,S2 




Store Characters under 
Mask 


STCM 


BE 


R1,M3,D2(B2) 


R1,M3,S2 




Store Clock 


STCK 


B205 


D1(B1) 


SI 




Store Clock Comparator 


STCKC 


B207 


D1(B1) 


SI 




Store Control 
Store CPU address 


STCTL 
STAP 


B6 
B212 


R1,R3,D2(B2) 

D2(B2) 

D1(BI) 


R1,R3,S2 
S2 




Store CPU ID 


STIDP 


B202 


SI 




Store CPU Timer 


STPT 


8209 


D1(B1) 


si 




Store Holfword 
Store Long 
Store Multiple 


STH 
STD 
STM 


40 
60 
90 


RI,D2(X2,B2)orRl,D2(,B2) 

R1,D2(X2,B2) 

R1,R2,D2(B2) 


R1,S2(X2) orRl,S2 
R1,S2(X2) orR1,S2 
RJ,R2,S2 




Store Prefix 


STPX 


B211 


D2(B2) 


S2 




Store Short 


STE 


70 


R1,D2(X2,B2)orR1,D2(,B2) 


R1,S2P<2) orRl,S2 




Store Then AND System Mask 


STNSM 


AC 


D1(B1),I2 
D1(B1),I2 
R1,D20<2) 


SI, 12 
SI, 12 
R1,S2(X2) orRl,S2 




Store Then OR System Mask 
Subtract 


STOSM 
S 


AD 
5B 




Subtract 


SR 


IB 


R1,R2 






Subtract Decimal 
Subtract Holfword 
Subtract Logical 
Subtract Logical 


SP 
SH 
SL 
SLR 


FB 
4B 
5F 

IF 


D1(L1,8I),D2(L2,B2) 
Rl,D2<X2,B2)orRl,D2(,B2) 
R1,D20<2,B2orRl D2(B2 
R1,R2 ' ' 


S1(Ll),S2(L2)orSl.S2 
R1,S2(X2) orRl,i2 
R1,S2(X2) orRl,S2 



*L^ 






See Note 2 at end of 
this appendix 



^ 
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c 









Program Interruptions 












Instruction 


Type of 
Instruction 


Possible 






Condition Code Set 






A 


s 


Ov 


P 


Op 


Other 


00 


01 


10 


• 1 




Move Long 


RR 


X 


X 




X 


X 




AAA 


AAB 


AAC 


AAD 




Move Numerics 


SS 


X 






X 






N 


N 


N 


N 




Move with Offset 


SS 


X 






X 






N 


N 


N 


N 




Move Zones 


SS 


X 






X 






N 


N 


N 


N 




Multiply 


RX 


X 


X 










N 


N 


N 


N 




Multiply 


RR 




X 










N 


N 


N 


N 




Multiply Decimal 


SS, Decimal 


X 


X 




X 


X 


Data 


N 


N 


N 


N 




Multiply Extended 


RR, Floating Pt. 




X 


E 




X 


B 


N 


N 


N 


N 




Multiply Halfword 


RX 


X 


X 










N 


N 


N 


N 




Multiply, Long 


RX, Floating Pt. 


X 


X 


E 




X 


B< 


N 


N 


N 


N 




Multiply, Long 


RR, Floating Pt. 




X 


E 




X 


B 


N 


N 


N 


N 




Multiply, Long/ 


RX,Floating Pt. 


X 


X 


E 


X 


X 


B 


N 


N 


N 


N 




Extended 


























Multiply, Long/ 


RR, Floating Pt. 




X 


E 




X 


B 


N 


N 


N 


N 




Multiply, Short 


RX, Floating Pt. 


X 


X 


E 




X 


B 


N 


N 


N 


N 




Multiply, Short 


RR,Floating Pt. 




X 


E 




X 


B 


N 


N 


N 


N 




No Operation 


RX,Ext.Mnemoni< 














N 


N 


N 


N 




No Operation 


RR, Ext. Mnemonic 














N 


N 


N 


N 




Or Logical 


RX 


X 


X 










J 


K 








Or Logical 


SS 


X 






X 






J 


K 








Or Logical 


RR 














J 


K 








Or Logical Immediate 


SI 


X 






X 






J 


K 








Pack 


SS 


X 






X 






N 


N 


N 


N 




Purge Translation Lookaside 
Buffer 


S 










X 


A 


N 


N 


N 


N 


Not DOSAGE 


. -._.— . 






















MM DOSAGE 


Read Direct 


SI 


X 






X 


X 


A 


N 


N 


N 


N 




Reset Reference Bit 


s 










X 


A 


AAQ 


AAR 


AAS 


AAT 


OQS/VSEoniy 


Retrieve Status and Page 


ss 


X 








X 


A 


ABM 






ABN 
AAT 


DQS/VSEonty 


Set Poge Bits 


RS 


X 








X 


A 


AAQ 


AAR 


AAS 




Set dock 


s 


X 


X 




X 


X 


A 


AAE 


AAF 




AAG 




Set Clock Comparator 


s 


X 


X 




X 


X 


A 


N 


N 


N 


N 




Set CPU Timer 


s 


X 


X 




X 


X 


A 


N 


N 


N 


N 




Set Prefix 


s 


> 








x 


A 












Set Program Mask 


RR 














RR 


RR 


RR 


RR 




Set PSW Key from Address 


S 










X 


A 












Set Storage Key 


RR 


X 


X 






X 


A 


N 


N 


N 


N 




Set System Mask 


SI 


X 










A 


N 


N 


N 


N 




Shift Left Double Algebraic 


RS 




X 


F 








J 


L 


M 


O 




Shift and Round Decimal 


SS 


X 




D 


X 


X 


Data 


J 


L 


M 


O 




Shift Left Double Logical 


RS 




X 










N 


N 


N 


N 




Shift Left Single Algebraic 


RS 






F 








J 


L 


M 


o 




Shift Left Single Logical 
Shift Right Double Algebraic 


RS 














N 


N 


N 


N 




RS 




X 










J 


L 


M 






Shift Right Double Logical 


RS 




X 










N 


N 


N 


N 




Shift Right Single Algebraic 


RS 














J 


L 


M 






Shift Right Single Logical 


RS 














N 


N 


N 


N 




Signal Processor 


RS 










X 


A 


AAY 


AAZ 


EE 


HH 




Start I/O 


S 












A 


MM 


CC 


EE 


KK 




Start I/O Fast Release 


S 












A 


MM 


cc 


EE 


KK 




Store 


RX 


X 


X 




X 






N 


N 


N 


N 


DOS/VSEonlv 


Store Capacity Catmft 


s 


w. 


" 


t» 




A 


AAH 


> * ■*>**'& ' 




*- ; ' \ ' ' ' 




Store Channel ID 


s 










X 


A 


CC 


AAI 


KK 




Store Character 


RX 


X 






X 






N 


N 


N 


N 




Store Characters under 


RS 


X 






X 


X 




N 


N 


N 


N 




Mask 


























Store Clock 


S 


X 






X 


X 




AAJ 


AAK 


AAN 


AAG 




Store Clock Comparator 


S 


X 


X 




X 


X 


A 


N 


N 


N 


N 




Store Control 


RS 


X 


X 




X 


X 


A 


N 


N 


N 


N 




Store CPU Address 


S 










x 


A 












Store CPU ID 


S 


X 


X 




X 


X 


A 


N 


N 


N 


N 




Store CPU Timer 


S 


X 


X 




X 


X 


A 


N 


N 


N 


N 




Store Halfword 


RX 


X 


X 




X 






N 


N 


N 


N 




Store Long 


RX, Floating Pt. 


X 


X 




X 


X 




N 


N 


N 


N 




Store Multiple 


RS 


X 


X 




X 






N 


N 


N 


N 




Store Prefix 


S 










X 


A 












Store Short 


RX, Floating Pt. 


X 


X 




X 


X 




N 


N 


N 


N 




Store Then AND System Mask 


SI 


X 






X 


X 


A 


N 


N 


N 


N 




Store Then OR System Mask 


SI 


X 






X 


X 


A 


N 


N 


N 


N 




Subtract 


RX 


K 


X 


F 








V 


X 


Y 


O 




Subtract 


RR 






F 








V 


X 


y 


O 
O 
O 
W,l 




Subtract Decimal 


SS, Decimal 


< 




D 


X 


X 


Data 


V 


X 


Y 




Subtract Halfword 


RX' 


X 


< 


F 








V 


X 


Y 




Subtract Logical 


RX 


K 


< 












W,H 
W,H 


V,l 




Subtract Logical 


RR 
















v,i 


W,'l 



Appendix IV: Machine Instruction Mnemonic Operation Codes 397 





Mnemonic 


Machine. 


Operand Format 


Instruction 


Operation 


Operation 








Code 


Cod* 


Explicit 


Implicit 


Subtract Normalized, 


SXR 


37 


R1,R2 




Extended 










Subtract Normalized, Long 


SD 


68 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 


Subtract Normalized, Long 


SDR 


2B 


R1,R2 




Subtract Normalized, Short 


SE 


78 


Rl,D2(X2,B2)orRJ,D2(,B2) 


R1,S2(X2) orRl,S2 


Subtract Normalized, Short 


SER 


38 


R1,R2 




Subtract Unnormalized, Long 


SW 


6F 


Rl,D2(X2,B2)orRl,D2(,B2) 


R1,S2(X2) orRl,S2 


Subtract Unnormalized, Long 


SWR 


2F 


R1,R2 




Subtract Unnormalized, Short 


SU 


7F 


R1,D2(X2,B2)orR1,D2(,B2) 


R1,S2(X2) orRl,S2 


Subtract Unnormalized, Short 


SUR 


3F 


R1,R2 




Supervisor Call 


SVC 


OA 


1 




Test and Set 


TS 


93 


D1(B1) 


SI 


Test Channel 


TCH 


9F 


D1(B1) 


SI 


Test I/O 


TIO 


9D 


D1(B1) 


SI 


Test Under Mask 


TM 


91 


01(81), 12 


SI, 12 


Translate 


TR 


DC 


D1(L,B1),D2(B2) 


S1(L),S2 orS1,S2 


Translate and Test 


TRT 


DD 


D1(L,B1),D2(B2) 


S1(L),S2 orS1,S2 


Unpack 


UNPK 


F3 


D1(L1,81),D2(L2,B2) 


Sl(Ll),S2(L2)orS1,S2 


Write Direct 


WRD 


84 


D1(B1),I2 


SI, 12 


Zero and Add Decimal 


ZAP 


F8 


D1(L1,B1),D2(L2,B2) 


Sl(Ll),S2(L2)orSl,S2 



'%jr. 
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Type of 


Program Interruption 








Instruction 


Instruction 


Possible 




Condition Code Set 


A 


S 


Ov 


P 


Op 


Other 


00 


01 


10 


11 


Subtract Normalized, Extended 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 






M 




Subtract Normalized, Long 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 






M 


Q 


Subtract Normalized, Long 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 






M 


Q 


Subtract Normalized, Short 


RX, Floating Pt. 


X 


X 


E 




X 


B,C 


R 






M 


Q 


Subtract Normalized, Short 


RR, Floating Pt. 




X 


E 




X 


B,C 


R 






M 


Q 


Subtract Unnormaliezd, Long 


RX, Floating Pt. 


X 


X 


E 




X 


C 


R 






M 


Q 


Subtract Unnormailezd, Long 


RR, Floating Pt. 




X 


E, 




X 


c 


R 






M 


Q 


Subtract Unnormaltzed, Short 


RX, Floating Pt. 


X 


X 


E 




X 


c 


R 






M 


Q 


Subtract Unnormalized, Short 


RR, Floating Pt. 




X 


E 




X 


c 


R 






M 


Q 


Supervisor Call 


RR 














N 


N 




N 


N 


Test and Set 


SI 


X 






X 






SS 


TT 








Test Channel 


SI 












A 


JJ 


II 




FF 


HH 


Test I/O 


SI 












A 


LL 


CC 




EE 


KK 


Test under Mask 


SI 


X 












UU 


W 






WW 


Translate 


SS 


X 






X 






N 


N 




N 


N 


Translate and Test 


SS 


X 












PP 


NN 


1 


OO 




Unpack 


SS 


X 






X 






N 


N 




N 


N 


Write Direct 


SI 


X 








X 


A 


N 


N 




N 


N 


Zero and Add Decimal 


SS, Decimal 


X 




D 


X 


X 


Data 


J 


L 




M 


O 


Program Interruptions Possible 










Under Ov: D = Decim 


al Under Other: A Privileged Operation 




E Floating Point Divide 


E = Expor 


ent 


B Exponent Underflow 




F Fixed Point Divide 


F = Fixed 


Point 


C Significance 
D Decimal Divide 




G Execute 
GA Monitoring 


Condition Code Set 










H No carry 


NN 


Nonzero function byte found before 




AAS Reference bit one, change bit zero 


1 Carry 




the first operand field is exhausted 




AAT Reference bit one, change bit one 


J Result = 


00 


Last function bytes are zero 




AAU Segment table entry invalid ( 1-bit one) 


K Result is not equal to zero 


PP 


Al 1 function bytes are zero 




AAV Translation available 


L Result is less than zero 


QQ 


Set according to bits 34 and 35 of thi 




AAW First and second hand operands equal, 


M Result is greater than zero 




new PSW looded 




second operand replaced by 


N Not changed 


RR 


Set according to bits 2 and 3 of the 




the third operand 


O Overflow 




register s pecified by Rl 




AAX No operation is in progress for 


P Result exponent underflows 


SS 


Leftmost bit of byte specified = 




the addressed device 


Q Result exponent overflows 


TT 


Leftmost bit of byte specified = 1 




AAY Order code accepted 


R Result fraction = 


UU 


Selected bits are all zeros; mask is a 


1 zeros 


AAZ Status stored 


S Result field equals to zero 


W 


Selected bits are mixed (zeros and ones) 


ABA Successful, block was disconnected, 


T Result field is less than zero 


WW 


Selected bits are all ones 




index returned 


U Result field is greater than ze 


ro XX 


Selected bytes are equal, or mask in zero 


ABB Page was already disconnected, 


V Difference = 


YY 


Selected field of first operand is low 




index returned 


W Difference is not euqal to zer 


o ZZ 


Selected field of first operand is high 




ABC Not successful, index returned 


X Difference is leu than zero 


AAA 


First operand and second operand counts 


ABD Page was connected 


Y Difference is greater than zer 





are equal 




ABE Page was already disconnected 


Z First operand equals second q 


>erand AAB 


First operand count is lower 




ABF Index returned, page is addressable 


AA First operand is less than seco 


nd operand AA£ 


First operand count is higher 




ABG Index returned, page is connected 


BB First operand is greater than s 


econd operand AAD 


No movement because of destructive overlap ABH ,nde * n0 * '"turned, page is 


CC CSW stored 


AAE 


Clock value set 




disconnected 


DD Channel and subchannel not v 


working AAF 


Clock value secure 




ABI Index not returned, address is invalid 


EE Channel or subchannel busy 


AAG 


Clock not operational 




ABJ Page was already addressable 


FF Channel operating in burst mc 


>d« AAH 


Channel ID correctly stored 




ABK Page was addressable 


GB Page state 


AAI 


Channel activity prohibited during ID 


ABL Page was already connected 


GC Page transision 


AAJ 


Clock value is valid 




ABM Save valid 


GG Burst operation terminated 


AAK 


Clock value not necessarily valid 




ABN Save invalid 


HH Channel not operational 


AAL 


Channel working with another device 






II Interruption pending on chanr 


'•' AAM 


Subchannel busy or interruption pend 


ing 




J J Channel available 


AAN 


Clock in error state 






KK Not operational 


AAO 


Segment- or page-table length violation 




LL Available 


AAP 


Page-table entry invalid (1-bit one) 






MM I/O operation initiated and c 


hannel AAQ 


Reference bit zero, change bit zero 






proceeding with its execution 


AAR 


Reference bit zero, change bit one 
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RR Format 


Operation 


Name 


Mnemonic 


Remarks 


Code 








00 








01 








02 








03 


4 






04 


Set Program Mask 


SPM 




• 05 


Branch and Link 


BALR 




06 


Branch on Count 


BCTR 




07 


Branch on Condition 


BCR 




08 


Set Storage Key 


SSK 




09 


Insert Storage Key 


ISK 




0A 


Supervisor Call 


SVC 




0B 








OC 








OE 


Move Long 


MVCL 




OF 


Compare Logical Long 


CLCL 




10 


Load Positive 


LPR 




11 


Load Negative 


LNR 




12 


Load and Test 


LTR 




13 


Load Complement 


LCR 




14 


AND 


NR 




15 


Compare Logical 


CLR 




16 


OR 


OR 




17 


Exclusive OR 


XR 




18 


Load 


LR 




19 


Compare 


CR 




1A 


Add 


AR 




IB 


Subtract 


SR 




1C 


Multiply 


MR 




ID 


Divide 


DR 




IE 


Add Logical 


ALR 




IF 


Subtract Logical 


SLR 




20 


Load Positive (Long) 


LPDR 




21 


Load Negative (Long) 


LNDR 




22 


Load and Test (Long) 


LTDR 




23 


Load Complement (Long) 


LCDR 




24 


Halve (Long) 


HDR 




25 


Load Rounded (Extended to Long) 


LRDR 




26 


Multiply (Extended) 


MXR 




27 


Multiply (Long to Extended) 


MXDR 




28 


Load (Long) 


LDR 




29 


Compare (Long) 


CDR 




2A 


Add Normalized (Long) 


ADR 




2B 


Subtract Normalized 


SDR 




2C 


Multiply (Long) 


MDR 




2D 


Divide (Long) 


DDR 




2E 


Add Unnormalized (Long) 


AWR 




2F 


Subtract Unnormalized (Long) 


SWR 




30 


Load Positive (Short) 


LPER 




31 


Load Negative (Short) 


LNER 




32 


Load and Test (Short) 


LTER 




33 


Load Complement (Short) 


LCER 




34 


Halve (Short) 


HER 




35 


Load Rounded (Long or Short) 


LRER 




36 


Add Normalized (Extended) 


AXR 




37 


Subtract Normalized (Extended) 


SXR 




38 


Load (Short) 


LER 
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• 

RR Format 


Operation 


Name 


Mnemonic 


Remarks 


Code 








39 


Compare ( Short ) 


CER 




3A 


Add Normalized (Short) 


AER 




3B 


Subtract Normalized (Short) 


SER 




3C 


Multiply (Short) 


MER 




3D 


Divide (Short) 


DER 




3E 


Add Unnormalized (Short) 


AUR 




3F 


Subtract Unnormalized (Short) 


SUR 




RX Format 


40 


Store Halfword 


STH 




41 


Load Address 


LA 




42 


Store Character 


STC 




43 


Insert Character 


IC 




44 


Execute 


EX 




45 


Branch and Link 


BAL 




46 


Branch on Count 


BCT 




47 


Branch on Condition 


BC 




48 


Load Halfword 


LH 




49 


Compare Halfword 


CH 




4A 


Add Halfword 


AH 




4B 


Subtract Halfword 


SH 




4C 


Multiply Halfword 


MH 




4E 


Convert to Decimal 


CVD 




4F 


Convert to Binary 


CVB 




50 


Store 


ST 




51 








52 








53 








54 


AND 


N 




55 


Compare Logical 


CL 




56 


OR 







57 


Exclusive OR 


X 




58 


Load 


L 




59 


Compare 


C 




5A 


Add 


A 




5B 


Subtract 


S 




5C 


Multiply 


M 




5D 


Divide 


D 




5E 


Add Logical 


AL 




5F 


Subtract Logical 


SL 




60 


Store ( Long ) 


STD 




61 








62 








63 








64 








65 


* 






66 








67 


Multiply (Long to Extended) 


MXD 




68 


Load (Long) 


LD 




69 


Compare (Long) 


CD 




6A 


Add Normalized (Long) 


AD 




6B 


Subtract Normalized (Long) 


SD 




6C 


Multiply (Long) 


MD 




6D 


Divide (Long) 


DD 




6E 


Add Unnormalized (Long) 


AW 




6F 


Subtract Unnormalized (Long) 


SW 
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RX Format 








Operation 


Name 


Mnemonic 


Remarks 


Code 








70 


Store (Short) 


STE 




71 








72 








73 








74 


V 






75 








76 








77 








78 


Load (Short) 


LE 




79 


Compare (Short) 


CE 




7A 


Add Normalized (Short) 


AE 




7B 


Subtract Normalized (Short) 


SE 




7C 


Multiply (Short) 


ME 




7D 


Divide (Short) 


DE 




7E 


Add Unnormalized (Short) 


AU 




7F 


Subtract Unnormalized (Short) 


SU 




RS,SI, and S 


Format 






80 


Set System Mask 


SSM 




81 








82 


Load PSW 


LPSW 




83 


"Diagnose L 






84 


Write Direct 


WRD 




85 


Read Direct 


RDD 




86 


Branch on Index High 


BXH 




87 


Branch on Index Low or Equal 


BXLE 




88 


Shift Right Single Logical 


SRL 




89 


Shift Left Single Logical 


SLL 




8A 


Shift Right Single 


SRA 




8B 


Shift Left Single 


SLA 




8C 


Shift Right Double Logical 


SRDL 




8D 


Shift Left Double Logical 


SLDL 




8E 


Shift Right Double 


SRDA 




8F 


Shift Left Double 


SLDA 




90 


Store Multiple 


STM 




91 


Test under Mask 


TM 




92 


Move (Immediate) 


MVI 




93 


Test and Set 


TS 




94 


AND (Immediate) 


NI 




95 


Compare Logical (Immediate) 


CLI 




96 


OR (Immediate) 


01 




97 


Exclusive OR (Immediate) 


XI 




98 


Load Multiple 


LM 




99 








9A 








9B 








9C 


Start I/O, Start I/O Fast Release 


SIO,SIOF 


See Note 2 


9D 


Test I/O 


TIO 




9£ 


Halt I/O, Halt Device 


HI0,HDV 


See Note 1 


9F 


Test Channel 


TCH 




A0 








Al 








A2 








A3 








A4 








A5 








A6 
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RS,SI, and S Format 


Operation 
Code 


Name 


Mnemonic 


Remarks 


A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 

BO 
Bl 
B2 
B3 
B4 
B5 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BF 


Store Then AND System Mask 
Store Then OR System Mask 

Connect Page 

Load Real Address 

(First byte of two-byte operation code 

Insert Page Bits 
Set Page Bits 
Store Control 
Load Control 
Load Frame Index 

Compare Logical Characters under Mask 
Store Characters under Mask 
Insert Characters under Mask 


STNSM 
STOSM 

CTP 
LRA 

3) 

IPB 

SPB 

STCTL 

LCTL 

LFI 

CLM 

STCM 

ICM 




SS Format 


CO 
CI 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
CA 
CB 
CC 
CD 
CE 
CF 

DO 
Dl 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
DA 
DB 
DC 


Move Numerics 

Move (Characters) ' 

Move Zones 

AND ( Char ac ter s ) 

Compare Logical (Characters) 

OR (Characters) 

Exclusive OR (Characters) 

Retrieve Status and Page 

Translate 


MVN 

MVC 

MVZ 

NC 

CLC 

OC 

XC 

RSP 

TR 





o 
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SS Format 


Operation 


Name 


Mnemonic 


Remarks 


Code 








DD 


Translate and Test 


TRT 




DE 


Edit 


ED 




DF 


Edit and Mark 


EDMK 




EO 


* 






El 








E2 








E3 








E4 








E5 








E6 








E7 








W8 








E9 








EA 








EB 








EC 








ED 








EE 








EF 








FO 


Shift and Round Decimal 


SRP 




Fl 


Move with Offset 


MVO 




F2 


Pack 


PACK 




F3 


Unpack 


UNPK 




F4 








F5 








F6 








F7 








F8 


Zero and Add Decimal 


ZAP 




F9 


Compare Decimal 


CP 




FA 


Add Decimal 


AP 




FB 


Subtract Decimal 


SP 




FC 


Multiply Decimal 


MP 




FD 


Divide Decimal 


DP 




FE 








FF 









'%J> 



NOTES 



1. Under the System/370 architecture, the machine operations for Halt Device and Halt 
I/O are as follows: 



1001 1110 XXXX XXXO 



1001 1110 XXXX XXXI 



Halt I/O 
Halt Device 



HIO 
HDV 



(X denotes an ignored bit position) 
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2. Under the System/370 architecture, the machine operations for Start I/O and Start 
I/O Fast Release are as follows: 

1001 1100 XXXX XXXO Start I/O SIO 

1001 1100 XXXX XXX1 Start I/O Fast Release SIOF 

(X denotes an ignored bit position) 



Operation 


Name 


Mnemonic 


Code 






AE 


Signal Processor 


SIGP 


BA 


Compare and Swap 


CS 


BB 


Compare Double and Swap 


CDS 


9D01 


Clear I/O 


CLRIO 


B202 


Store CPU ID 


STIDP 


B203 


Store Channel ID 


STIDC 


B204 


Set Clock 


SCK 


B205 


Store Clock 


STCK 


B206 


Set Clock Comparator 


SCKC 


B207 


Store Clock Comparator 


STCKC 


B208 


Set CPU Timer 


SPT 


B209 


Store CPU Timer 


STPT 


B20A 


Set PSW Key from Address 


SPKA 


B20B 


Insert PSW Key 


IPK 


B20D 


Purge Translation 






Lookaside Buffer 


PTLB 


B210 


Set Prefix 


SPX 


B211 


Store Prefix 


STPX 


B212 


Store CPU Address 


STAP 


B213 


Reset Reference Bit 


RRB 


B215 


Clear Page 


CLRP 


B21B 


Deconfigure Page 


DEP 


B21C 


Disconnect Page 


DCTP 


B21D 


Make Addressable 


MAD 


B21E 


Make Unaddressable 


MUN 


B21F 


Store Capacity Counts 


STCAP 



-f'X 
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Appendix V: Assembler Instructions 



Operation 
ACTR 



Name Entry 

A sequence symbol 
or blank 



Operand Entry 

A SETA expression 






A30 A sequence symbol 

or blank 

AIF A sequence symbol 

or blank 



ANOP A sequence symbol 

or blank 

CCW Any symbol or 

blank 

CNOP Any symbol or 

blank 

OS 
C0K ©rtv ^y symbol or 

^^ blank 
005 Must be blank 

COPY Must not be present 

CSECT Any symbol or 
blank 



A sequence symbol 



A logical expression enclosed 
in parentheses, immediately 
followed by a sequence symbol 

Not required 



Four operands, separated by 
commas 

Two absolute expressions, 
separated by a comma 

Not required 

Not required 

One ordinary symbol 

Not required 



or 



OS 



DC 


Any symbol 
blank 


or 


DROP 


A sequence 
or blank 


symbol 


DS 


Any symbol 
blank 


or 


DSECT 


Any symbol 
blank 


or 


DXD 


Any symbol 




EJECT 


A sequence 


symbol 



or blank 



One or more operands, separated 
by commas 

One to sixteen absolute 
expressions, separated by 
conroas; or blank 

One or more operands,, separated 
by commas 

Not required 



One or more operands, separated 
by commas 

Not required 



END 



ENTRY 



A sequence symbol 
or blank 

A sequence symbol 
or blank 



A relocatable expression or 
blank 

One or more relocatable symbols, 
separated by commas 
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Operation 



EOiJ 



SX'IRN 



GBLA 



Name Entry 

An ordinary symbol 
or a variable 
symbol 

A sequence symbol 
or blank 



Operand Entry 

One to three operands, 
separated by commas 
DOS Only one operand. 

One or more relocatable symbols, 
separated by commas 



Fust not be present One or more variable symbols 

that are to be used as SET 
symbols, separated by commas 2 






GBLB 



GBLC 



ICTL 



ISEQ 



LCLA 



LCLB 



LCLC 



Fust not be present 



Fust not be present 



Fust not be present 



Fust not be present 



Fust not be present 



Fust not be present 



Fust not be present 



LTORG 


Any symbol or 
blank 


MACRO 1 


Fust not be prese; 


FEND 1 


A sequence symbol 
or blank 


MEXIT 1 


A sequence symbol 
or blank 


FNOTE 


A sequence symbol 
or blank 



One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 2 

One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 2 

One to three decimal values, 
separated by commas 

Two decimal values, separated 
by commas 

One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 2 

One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 2 

One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 2 

Not required 



Not required 
Not required 

Not required 



A severity code followed by a 
comma (this much is optional) 
followed by any combination of 
characters enclosed in 
apostrophes 



^ 



*Can be used only as part of a macro definition. 

2 SET symbols can be defined as subscripted SET symbols. 
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Operation 







OS 
*f*ty 



ORG 

POP 

PRINT 

PUNCH 

PUSH 

RE PRO 

SETA 
SETB 

SETC 



SPACE 



START 



TITLE 



Name Entry 

*Ari "oi&iiiary symbol 



A machine instruc- 
tion mnemonic code, 
an extended mnemon- 
ic code, an assem- 
bler operation, an 
operation code def- 
ined by a previous 
OPSxN instruction 

OS Any symbol or 
only blank 

DOS A sequence symbol 
only or blank 

A sequence symbol 
or blank 

A sequence symbol 
or blank 

A sequence symbol 
or blank 

A sequence symbol 
or blank 

A sequence symbol 
or blank 

A SETA symbol 

A SETB symbol 

A SETC symbol 



A sequence symbol 
or blank 

Any symbol or 
blank 

A string of alpha- 
meric characters. 
A variable symbol. 
A combination of 
the above. 
A sequence symbol. 
A blank 



Operand Entry 

A machine instruction mnemonic 
code, an extended mnemonic code, 
a macro operation, an assembler 
operation, an operation code 
defined by a previous OPSYN 
instruction, or blank 

Blank 



A relocatable expression or 

blank 

A relocatable expression or 

blank 

One or more operands, separated 
by a comma 

One to three operands 



One to eighty characters, 
enclosed in apostrophes 

One or more operands, separated 
by a comma 

Not required 



An arithmetic expression 

A or a 1, a SETB symbol, or a logical 
expression enclosed in parentheses 

A type attribute, a character 

expression, a substring 

notation, or a concatenation 

of character expressions 

and substring notations. 
7** A duplication factor (a SETA 
-f*t expression enclosed in parentheses) 

can precede the above if desired. 

A decimal self-defining 
term or blank 

A self-defining term or blank 



One to 100 characters, enclosed 
in apostrophes 
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Operation 
USING 



WXTRN 



A sequence syiribol 
or blank 



A sequence symbol 
or blank 



Operand Entry 

An absolute or relocatable 
expression followed by 1 to 16 
absolute expressions , separated 
by commas 

One or more relocatable 
symbols, separated by commas 



/f^N 



Instruction 



Name Entry 



Operand Entry 



Model Statements 3 



Prototype Statement 2 



An ordinary symbol, 
a variable symbol, 
a sequence 
symbol, a combina- 
tion of variable 
symbols and other 
characters that is 
equivalent to a 
symbol, or blank 

A symbolic para- 
meter or blank 



Macro- Instruction 
Statement 2 



Assembler Language 
Statement 3 



Any combination of char- 
acters (including 
variable symbols) 



Zero or more operands 

that are symbolic parameters, 

separated by commas 

Zero or more positional 
operands and/or zero 
or more keyword operands 
separated by commas 2 



Any combination of charac- 
ters (including variable 
symbols) 



An ordinary symbol, 
a variable symbol, 
a sequence symbol, 
a combination of 
variable symbols 
and other charac- 
ters that is equiv- 
alent to a symbol, 2 
or blank 

An ordinary symbol, 
a variable symbol, 
a sequence symbol, 
a combination of 
variable symbols 
and other charac- 
ters that is equiv- 
alent to a symbol, 
or blank 

1 Can only be used as part of a macro definition. 

2 Variable symbols appearing in a macro instruction are replaced 
by their values before the macro instruction is processed. 

3 Restrictions on the use of variable symbols 

in statement fields are included in the descriptions 
for each individual statement and in "Rules 
for Model Statement Fields" (See J4B) . 



v Ol 



># 



<tio 






Appendix VI: Summary of Constants 



T T" 

NUMBER 
OF CON- 
STANTS 

PER 
OPERAND 



TRUN- 
CATION/ 
PADDING 
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(1) In a DS assembler instruction C and X type constants can have length specification 
to 65535. 

(2) Bit length specification permitted with absolute expressions only. Relocatable A- 
type constants, 3 or 4 bytes only; relocatable Y-type constants, 2 bytes only. 

(3) Errors will be flagged if significant bits are truncated or if the value specified 
cannot be contained in the implicit length of the constant. 
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Appendix VII: Summary of Macro Facility 



The four charts in this Appendix summarize the macro facility described in Part IV of 
this publication. 

Chart 1 indicates which macro language elements can be used in the name and operand 
entries of each statement. , 

Chart 2 is a summary of the expressions that can be used in macro instruction statements. 

Chart 3 is a summary of the attributes that may be used in each expression. 

Chart 4 is a summary of the variable symbols that can be used in each expression. 
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1 . Variable symbols in macro- instructions are replaced by their values before processing . 

2. Only if value is self-defining term. 

3. Converted to arithmetic +1 or -K). 

4. Only in character relations. 

5. Only in arithmetic relations. 

6. Only in arithmetic or character relations. 

7. Converted to unsigned number. 
8 ♦ Converted to character 1 or . 

9. On 2,147 f 4$3,64?) OS 
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Chart 2. Conditional Assembly Expressions 
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Expression Arithmetic Expressions 


Character Expressions 


Logical Expressions 


Can contain • 

• 


Self-defining terms 

Length, scaling, 
integer, count, and 
number attributes 


• Any combination of 
characters enclosed 
in apostrophes 


• A or a 1 

• SETB symbols 


• 


SETA and SETB 
symbols 1 


• Any variable symbol 
enclosed in 
apostrophes 


• Arithmetic 
relations * 


• 


SETC symbols whose 
values are a decimal 
self-defining term 1 


• A concatenation of 
variable symbols and 
other characters 
enclosed in 
apostrophes 


• Character 
relations 2 


• 


6SYSPARM if its 
value is a decimal 
self -defining term 






• 


Symbolic parameters 
if the corresponding 
operand is a decimal 
self-defining term 


• A type attribute 
reference 




• 


SSYSLIST (n) if the 
corresponding 
operand is a decimal 
self-defining term 






• 


6SYSLIST 0i,m) if the 
corresponding operand 
is a decimal self- 
defining term 






• 


SSYSNDX 






• Values must 


be: 






!&S from 


through 2,147 ,4 83 ,647 






BOS from 


through 99,999,999 






2 A character relation consists of two character expressions 
related by the operator GT, LT, EQ, MB, GE f or LE. Type 
attribute notation and Substring notation may also be 
used in character relations. The maximum size of the character 
expressions that can be compared is 255 characters. If the two 
character expressions are of unequal size, the the smaller one 
will always compare less than the larger. 
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Operations 
are 


Arithmetic Expressions 

+, - (unary and bi- 
nary) , *, and /; 
parentheses per- 
mitted 


Character Expressions 

Concatenation, with a 
period (.) 


Logical Expressions 

AND, OR, and NOT 
parentheses per- 
mitted 


Range 

of values 


-2 3 « to *2 3 *-1 


through 255 
characters 


(false) or 

1 (true) 


May be 
used in 


• SETA operands 

• Arithmetic relations 

• Subscripted SET 
symbols 

• 6SYSLIST subscript (s) 

• Substring notation 

• Sublist notation 


• SETC operands 

• Character relations 3 


• SETB operands 

• AIF operands 


1 An arithmetic relation consists of two arithmetic expressions 
related by the operators GT, LT, EQ, NE, GE, or LE. 

2 A character relation consists of two character expressions 
related by the operator GT, LT, EQ, NE, GE, or LE. Type 
attribute notation and Substring notation may also be 

used in character relations. The maximum size of the character 
expressions that can be compared is 255 characters. If the two 
character expressions are of unequal size, the the smaller one 
will always compare less than the larger. 
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Chart 3. Attributes 
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symbolic parameters 
inside macro defini- 
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1 . SETC operand 
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Length 


L' 


Ordinary Symbols de- 
fined in open code; 
symbolic parameters 
inside macro defini- 
tions; SSYSLIST fln) , 
and SSYSLIST (m f n) in- 
side macro definitions 


Any letter except 
M, N,0, T and U 


Arithmetic 
expressions 


Scaling 


S* 


Ordinary Symbols de- 
fined in open code; 
symbolic parameters 
inside macro defini- 
tions; SSYSLIST (m) , 
and SSYSLIST (m f n) in- 
side macro definitions 


H,F,G,D,E,L,K,P, 
and Z 


Arithmetic 
expressions 


Integer 


1« 


Ordinary Symbols de- 
fined in open code; 
symbolic parameters 
inside macro defini- 
tions; SSYSLIST (m) , 
and SSYSLIST (m,n) in- 
side macro definitions 


H,F,G,D,E,L,K,P, 
and Z 


Arithmetic 
expressions 


Count 




Symbolic parameters, 
SSYSL 1ST (m) and 
SSYSLIST (m,n) inside 
macro definitions 

| system iable 

f symbols - : 


Any letter 


Arithmetic 
expressions 


Number 


N» 


Symbolic parameters, 
SSYSLIST and 
SSYSLIST (m) inside 
macro definitions 


Any letter 


Arithmetic 
expressions 



NOTE: There are definite restrictions in the use of these attributes ( see L1B) 
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Chart 4. Variable Symbols (Part 1 of 2) 
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expressions 
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SETA 
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• Character 
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expressions 


SETC 
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(null) 


SETC 
instruction 


• Arithmetic 
expressions 
if value is 
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• Character 
expressions 


&SYSNDX 1 


The assembler 


Macro 

instruction 

index 
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throughout 
definition ; 
unique for 
each macro 
instruction) 
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expressions 
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expressions 


&SYSECT 1 


The assembler 


Control 
section in 
which macro 
instruction 
appears 
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throughout 
definition; 
set by CSECT, 
DSECT, START, 
and COM) 


• Character 
expressions 
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Not applicable 
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• N' SSYSLIST in 
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expressions 


&SYSLIST 
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&SYSLIST 
(n,m) 1 
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macro instruc- 
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throughout 
definition) 


• Arithmetic 
expressions 
if operand 
is decimal 
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• Character 
expressions 
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1 Can be used only in macro definitions. 
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Chart 4. 


Variable Symbols cont. (Part 2 of 


2) 
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Initialized, 
or set to: 


Value changed 
by: 


May be used in: 


SSYSPARM 




PARM field 


User defined 
or null 


Constant 

throughout 

assembly 


• Arithmetic 
expression 
if value is 
decimal self- 
defining term 

• Character 
expression 


&SYSTIME 




The assembler 


System time 


Constant 

throughout 

assembly 
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expression 


gSYSDATE 


The assembler 


System date 


Constant 

throughout 

assembly 
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expression 



1 Can be used only in macro definitions. 
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Glossary 



This glossary has three main types cf definitions that 
apply: 

• To the assembler language in particular (usually 
distinguished by reference to the words ■assembler", 
"assembly", etc.) 

• To programming in general 

• To data processing as a whole 



If you do not understand the meaning of a data processing 
term used in any of the definitions below, refer to the I EN 
Data Processing Glossary , Order No. GC20-1699. 



IBM is grateful to the American National Standards Institute 
(ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for Information 
Processing, which was prepared by Subcommittee X3K5 on 
Terminology and Glossary of Airerican National Standards 
Committee X3. 

ANSI definitions are preceded by an asterisk (*) . 
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• absolute address ; A pattern of characters 
that identifies a unique storage location 
without further modification. 

absolute expression ; An assembly- time 
expression whose value is not affected by 
program relocation. An absolute expression 
can represent an absolute address. 

absolute term ; A term whose value is not 
affected by relocation. 

• address ; 

1. An identification, as represented by a 
name, label, or number, for a register, 
location in storage, or any ether data 
source or destination such as the 
location of a station in a 
communication network. 

2. Loosely, any part of an instruction 
that specifies the location of an 
operand for the instruction. Synonymous 
with address reference. 

3. See absolute address, base address, 
explicit address, implicit address, 
symbolic address. 

address constant ; A value, or an expression 
representing a value, used in the 
calculation of storage addresses. 

address reference ; Same as address (2) . 

alignment ; The positioning of the beginning 
of a machine instruction, data constant, or 
area on a proper boundary in virtual 
storage . 

alphabetic character ; In assembler 
programming, the letters A through Z and $, 
#, a. 

• alphameric ; Same as alphanumeric. 

•alphanumeric ; Pertaining to a character set 
that contains letters, digits, and usually, 
other characters, such as punctuation 
marks. Synonymous with alphameric. 

• AND ; A logic operator having the property 
that if P is a statement, Q is a statement, 
R is a statement,..., then the AND of P, Q, 
R,... is true if all statements are true, 
false if any statement is false. 

arithmetic expression ; A conditional 
assembly expression that is a combination 
of arithmetic terms, arithmetic operators, 
and paired parentheses. 

arithmetic operator ; 

1. In assembler programming, an operator 
that can be used in an absolute or 
relocatable expression, or in an 
arithmetic expression to indicate the 



2. 



actions to be performed on the terms in 
the expression. The arithmetic 
operators allowed are: +, -, *, /. 
See binary operator, unary operator. 






arithmetic relation ; Two arithmetic 
expressions separated by a relational 
operator. 

• arithmetic shift : 

1. A shift that does not affect the sign 
position. 

2. A shift that is equivalent to the 
multiplication of a number by a 
positive or negative integral power of 
the radix. 

ari t hmetic ter m; A term that can be used 
only In an arithmeitc expression. 

array ; In assembler programming, a series 
of one or more values represented by a SET 
symbol . 

• assemble ; To prepare a machine language 
program from a symbolic language program by 
substituting absolute operation codes for 
symbolic operation codes and absolute or 
relocatable addresses for symbolic 
addresses. 

• assembler ; A computer program that 
assembles. 

assembler ins truction : 

1. An assembler language statement that 
causes the assembler to perform a 
specific operation. Unlike the machine 
instructions, the assembler 
instructions are not translated into 
machine language. 

2. See also conditional assembly 
instruction, macro processing 
instruction. 

assembler language : A source language that 
includes symbolic machine language 
statements in which there is a one-to-one 
correspondence with the instruction formats 
and data formats of the computer. The 
assembler language also includes statements 
that represent assembler instructions and 
macro instructions. 

assembly time ; The time at which the 
assembler translates the symbolic machine 
language statements into their object code 
form Machine instructions) . The assembler 
also processes the assembler instructions 
at this time, with the exception of the 
conditional assembly and macro processing 
instructions, which it processes at 
pre-assembly time. 
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attribute ; A characteristic of the data 
defined in a source module. The assembler 
assigns the value of an attribute to the 
symbol or macro instruction operand that 
represents the data. Synonymous with data 
attribute. 



•base ; 

1 . A number that is multiplied by itself 
as many times as indicated by an 
exponent. 

2. See floating-point base. 

•base address ; A given address froxr which an 
absolute address is derived by combination 
with a relative address. NOTE; In 
assembler programming, the relative address 
is synonymous with displacement. 

base register ; A register that contains the 
base address. 

• binary ; Pertaining to the number 
representation system with a radix of two. 

•binary digit ; In binary notation, either of 
the characters, or 1. 

binary operator ; An arithmetic operator 
having two terms. The binary operators 
that can be used in absolute or relocatable 
expressions and arithmetic expressions are; 
addition (+) , subtraction (-) , 
multiplication (*) , and division (/) . 
Contrast with unary operator. 

• bit ; A binary digit. 

bit-length modifier ; A subfield in the DC 
assembler instruction that determines the 
length in bits of the area into which the 
defined data constant is to be assembled. 

bit string ; A string of binary digits in 
which the position of each binary digit is 
considered as an independent unit. 

blank ; In assembler programming, the same 
as space character. 

• blank character ; Same as space character. 

boundary ; In assembler programming, a 
location in storage that marks the 
beginning of an area into which data is 
assembled. For example, a fullword boundary 
is a location in storage whose address is 
divisible by four. The other boundaries 
are; doubleword (location divisible by 
eight) , halfword (location divisible by 
two) , and byte (location can be any 
number) . See also alignment. 



• branch ; Loosely, a conditional jump. 

buffer ; An area of storage that is 
temporarily reserved for use in performing 
an input/output operation, and into which 
data is read or from which data is written. 

• bug ; A mistake or malfunction. 

byte ; 

1 . A sequence of adjacent binary digits 
operated upon as a unit and usually 
shorter than a computer word. 

2. The representation of a character; 
eight binary digits (bits) in 
System/370. 



call ; 
•1. To transfer control to a specified 
closed subroutine . 
2. See also macro call. 

• character ; 

1. A letter, digit, or other symbol that 
is used as part of the organization, 
control, or representation of data. A 
character is often in the form of a 
spatial arrangement of adjacent or 
connected strokes . 

2. See blank character, character set, 
special character. 

character expression ; A character string 
enclosed by apostrophes. It can be used 
only in conditional assembly instructions. 
The enclosing apostrophes are not part of 
the value represented. Contrast with quoted 
string. 

character relation ; Two character strings 
separated by a relational operator. 

character set ; 
•1. A set of unique representations called 
characters, for example, the 26 letters 
of the English alphabet, and 1 of the 
Boolean alphabet, the set of signals in 
the Morse code alphabet, the 128 
characters of the ASCII alphabet. 
2. In assembler programming, the 

alphabetic characters A through Z and 
$ t #, S); the digits, through 9; and 
the special characters •«■-*/# ( ) = 
. ' S and the blank character. 

• character s trin g; A string consisting 
solely of characters. 

closed subroutine ; A subroutine that can be 
stored at one place and can be linked to 
one or more calling routines. Contrast with 
open subroutine. 
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• code : 

1. A set of unambigous rules specifying 
the way in which data nay be 
represented, for example, the set. of 
correspondences in the standard code 
for information interchange. 

2. In data processing, to represent data 
or a computer program in a symbolic 
form that can be accepted by a data 

-processor. 

3. To write a routine. 

4. See condition code, object code, 
operation code. 

• coding : See symbolic coding. 

collating sequence : An ordering assigned to 
a set of items, such that any twc sets in 
that assigned order can be collated. 

• column : A vertical arrangement of 
characters or other expressions. 

comments statement : A statement used to 
include information that may be helpful in 
running a job or reviewing an output 
listing. 

• complement : 

1. A number that can be derived from a 
specified number by subtracting it from 
a second specified number. For 
example, in radix notation, the second 
specified number may be given power of 
the radix or one less than the given 
power of the radix. The negative of the 
number is often represented by its 
complement. 

2. See radix complement, twos complement. 

complex relocatable expression : A 
relocatable expression that contains two or 
more unpaired relocatable terms or an 
unpaired relocatable term preceded by a 
minus sign, after all unary operators have 
been resolved. A complex relocatable 
expression is not fully evaluated until 
program fetch time. 

• computer program : A series of instructions 
or statements, in a form acceptable to a 
computer, prepared in order to achieve a 
certain result. 

• computer word : A sequence of bits or 
characters treated as a unit and capable of 
being stored in one computer location. 

concatenation character : The period (.) 
that is used to separate character strings 
that are to be joined together in 
conditional assembly processing. 



condition code : A code that reflects the 
result of a previous input/output, 
arithmetic, or logical operation. 

conditional assembl y: An assembler facility 
for altering at pre-assembly time the 
content and sequence of source statements 
that are to be assembled. 

conditional assembly expression : An 
expression that the assembler evaluates at 
pre-assembly time. 

conditional assembly instruction : An 
assembler instruction that performs a 
conditional assembly operation. Conditional 
assembly instructions are processed at 
pre-assembly time. They include: the LCLA, 
LCLB, LCLC, GBLA, GBLB , and the GBIC 
declaration instructions; the SETA, SETB, 
and SETC assignment instructions; the AIF, 
AGO, ANOP, and ACTR branching instructions. 

• conditional jump: a jump that occurs if 
specified criteria are met. 

• constant : See figurative constant. 

continuation l i ne: a line of a source 
statement into which characters are entered 
when the source statement cannot be 
contained on the preceding line or lines. 

control prog ram: A program that is designed 
to schedule and supervise the performance 
of data processing work by a computing 
system. 

control secti on: That part of a program 
specified by the programmer to be a 
relocatable unit, all elements of which are 
to be loaded into adjoining virtual storage 
locations. Abbreviated CSECT. 

control stat emen t : See linkage editor 
control statement. 

copy : To reproduce data in a new location 
or other destination, leaving the source 
data unchanged, although the physical form 
of the result may differ from that of the 
source. For example, to copy a deck of 
cards onto a magnetic tape. 

count attribute (K* ) : An attribute that 
gives the number of characters that would 
be required to represent the data as a 
character string. 

• counter : 

1. A~"device such as a register or storage 
location used to represent the number 
of occurrences of an event. 

2. See instruction counter, location 
counter. 
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CPU ; Central processing unit. 
CSECT ; See control section. 

data attribute : Same as attribute. 

data constant ; See figurative constant. 

•debug ; To detect, locate, and remove 
mistakes from a routine or malfunctions 
from a computer. 

• decimal ; Pertaining to the number 
representation system with a radix of ten. 

declare ; To identify the variable symbols 
to be used by the assembler at pre-assembly 
time. 

• delimiter ; A flag that separates and 
organizes items of data. 

• device ; See storage device. 

• dictionary ; See external symbol dictionary. 

dimension ; The maximum number of values 
that can be assigned to a SET symbol 
representing an array. 

dimensioned SET symbol ; A SET symbcl, 
representing an array, followed by a 
decimal number enclosed in parentheses. A 
dimensioned SET symbol must be declared in 
a global (GBLA, GBLB, or GBLC) or local 
(LCLA, LCLB, LCLC) declaration instruction. 

displacement ; 
•1. Same as relative address. 

2. In assembler programming, the 

difference in bytes between a symbolic 
address and a specified base address. 

doubleword : A contiguous sequence cf bits 
or characters which comprises two computer 
words and is capable of being addressed as 
a unit. 

NOTE: In assembler programming, the 
doubleword has a length of eight bytes and 
can be aligned on a doubleword boundary (a 
location whose address is divisible by 
eight). Contrast with fullword, halfword. 

• dummy ; Pertaining to the characteristic of 
having the appearance of a specified thing 
but not having the capacity to function as 
such. For example, a dummy control 
section. 






dummy control section : A control section 
that the assembler can use to format an 



area of storage without producing any 
object code. Synonymous with dummy section. 

dummy section ; Same as dummy control 
section. 

duplication factor ; In assembler 
programming, a value that indicates the 
number of times that the data specified 
immediately following the duplication 
factor is to be generated. For example, the 
first subfield of a DC or DS instruction is 
a duplication factor. 

• dynamic storage allocation ; A storage 
allocation technique in which the location 
of computer programs and data is determined 
by criteria applied at the moment of need. 



EBCDIC ; Extended binary coded decimal 
interchange code. 

entry name ; A name within a control section 
that defines an entry point and can be 
referred to by any control section. 

• entry point ; In a routine, any place to 
which control can be passed. 

entry symbol : 

1. An ordinary symbol that represents an 
entry name (identified by the ENTRY 
assembler instruction) or control 
section name (defined by the CSECT or 
START assembler instruction) . 

2. See also external symbcl. 

EQ ; (equal to) See relational operator. 

•error message ; An indication that an error 
has been detected. Contrast with warning 
message. 

ESP ; External symbol dictionary. 

excess sixty-four binary notation : In 
assembler programming, a binary notation in 
which each exponent of a floating-point 
number E is represented by the binary 
equivalent of E plus sixty-four. 

execution tim e: The time at which the 
machine instructions in object code form 
are processed by the central processing 
unit of the computer. 

explicit address : An address reference 
which is specified as two absolute 
expressions. One expression supplies the 
value of a base register and the other 
supplies the value cf a displacement. The 
assembler assembles both values into the 
object code of a machine instruction. 
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exponent ; 
•1. In a floating-point representation, the 
numeral, of a pair of numerals 
representing a number, that indicates 
the power to which the base is raised. 

2. See also excess sixty- four binary 
notation. 

exponent modifier ; A subfield in the 
operand of the DC assembler instruction 
that indicates the power of ten by which a 
number is to be multiplied before being 
assembled as a data constant. 

expression : 

1. One or more operations represented by a 
combination of terms, and paired 
parentheses. 

2. See absolute expression, arithmetic 
expression, complex relocatable 
expression, relocatable expression. 

3. See also character expression. 

extended binary coded decimal interchange 
code ; A set of 256 characters, each 
represented by eight bits. 

external name ; A name that can be referred 
to' by any control section or separately 
assembled module; that is, a control 
section name or an entry name in another 
module. 

external reference ; A reference to a symbol 
that is defined as an external name in 
another module. 

external symbol ; 

1. An ordinary symbol that represents an 
external reference. An external symbol 
is identified in a source module by the 
EXTRN or WXTRN assembler instruction, 
or by the V-type address constant. 

2. Loosely, a symbol contained in the 
external symbol dictionary. 

3. See also entry symbol. 

external symbol dictionary ; Contrcl 
information associated with an object or 
load module which identifies the external 
symbols in the module. Abbreviated ESD. 

EXTRN; External reference. 



fetch: 



•1. 



2. 



To locate and load a quantity of data 
from storage. 

In the Operating System (OS) , to obtain 
load modules from auxiliary storage and 
load them into virtual storage. See 
also loader (1) . 



3. In the Disk Operating System (DOS) , to 
bring a program phase into virtual 
storage from the core image library for 
immediate execution. 

4. A control program routine that 
accomplishes (1) , (2) , or (3). See also 
loader (2) . 

5. The name of the system macro 
instruction (FETCH) used to accomplish 

(1) , (2) , or (3) . 

• figurative c onstant; P. preassigned, fixed, 
character string with a preassigned, fixed, 
data name in a particular programming 
language. 

NOTE: In assembler programming, the two 
types of figurative constant are: 

a. data and address constants defined 
by the DC assembler instruction. 

b. symbols assigned values by the EQU 
assembler instruction. 

flag: 
•1. Any of various types of indicators used 
for identification. For example, in 
assembler programming, the paired 
apostrophes that enclose a character 
expression of a quoted string. 

2. In assembler programming, to indicate 
the occurrence of an error. 

* floating-poin t base : In floating-point 
representation, the fixed positive integer 
that is the base of the power. NOTE: In 
assembler programming, this base is 16. 

full word : A contiguous sequence of bits or 
characters which comprises a computer word 
and is capable of being addressed as a 
unit. 

NOTE: In assembler programming, the 
fullword has a length of four bytes and can 
be aligned on a fullword boundary (a 
location whose address is divisible by 
four) . Contrast with doubleword, halfword. 



GE ; (greater than or equal to) 
relational operator. 



See 



*1. To produce a program by selection of 
> subsets from a set of skeletal coding 
under the control of parameters. 
2. In assembler programming, to produce 
assembler language statements from the 
model statements of a macro definition 
when the definition is called by a 
macro instruction. 

global scope ; Pertaining to that part of an 
assembler program that includes the body of 
any macro definition called from a source 
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module and the 
source module. 



open code portion of the 
Contrast with local scope. 



{ f\ 



global variable symbol : 

1. A variable symbol that can be used to 
communicate values between macro 
definitions and between a mac re 
definition and open code. 

2. Contrast with local variable symbol. 

GT: (greater than) See relational operator*. 



+ halfword : A contiguous sequence of bits or 
characters which comprises half a computer 
word and is capable of being addressed as a 
unit. 

NOTE: In assembler programming, the 
halfword has a length of two bytes and can 
be aligned on a halfword boundary (a 
location whose address is divisible by 
two) . Contrast with doubleword, fullword. 

hexadecimal : Pertaining to a number system 
with a radix of sixteen; valid digits range 
from through F, where F represents the 
highest units position (15) . 



immediate data : Data specified in an SI 
type machine instruction that represents a 
value to be assembled into the object code 
of the machine instruction. 

implicit address : An address reference 
which is specified as one absolute or 
relocatable expression. An implicit address 
must be converted into its explicit 
base-displacement form before it can be 
assembled into the object code of a machine 
instruction. 

index register : 
•1. A register whose content may be added 
to or subtracted from the operand 
address prior to or during the 
execution of a computer instruction. 
2. In assembler programming, a register 
whose content is added to the cperand 
or absolute address derived frcm a 
combination of a base address with a 
displacement. 

inner macro instruction : A macro 
instruction that is specified, that is, 
nested inside a macro definition. Contrast 
with outer macro instruction. 

•instruction : 
1. A statement that specifies an operation 
and the values or locations of its 
operands. 



2. See assembler instruction, conditional 
assembly instruction, machine 
instruction, macro instruction. 

• instruction counter : A counter that 
indicates the location of the next computer 
instruction to be interpreted. 

instruction statemen t: See instruction (1). 

integ e r att ri bute (!') : An attribute that 
indicates the~number of digit positions 
occupied by the integer portion of 
fixed-point, decimal, and floating-point 
constants in their object code form. 

• interrupt : To stop a process in such a way 
it can be resumed. 

• I/O : An abbreviation for input/output. 



• job control sta te m ent: A statement in a job 
that is used in identifying the job or 
describing its requirements to the 
operating system. 

• jump : 

1. A departure from the normal sequence of 
executing instructions in a computer. 

2. See conditional jump. 



keyword : In assembler programming, an 
ordinary symbol containing up to seven 
characters. A keyword is used to identify a 
parameter, called a keyword parameter, in a 
macro prototype statement and the 
corresponding macro instruction operand. 

keyword operand ; An operand in a macro 
instruction that assigns a value to the 
corresponding keyword parameter declared in 
the prototype statement of the called macro 
definition. Keyword operands can be 
specified in any order, because they 
identify the corresponding parameter by 
keyword and not by their position. 
NOTE: In assembler programming, the 
specification of a keyword operand has the 
format: a keyword followed by an equal sign 
which, in turn, is followed by the value to 
be assigned to the keyword parameter. 

keyword parameter: A symbolic parameter in 
which the"~symbol following the ampersand 
represents a keyword. 
NOTE: In assembler programming, the 
declaration of keyword parameter has the 
format: a keyword parameter followed by an 
equal sign which, in turn, is followed by a 
standard (default) value. 



Glossary 427 



label : 
*1. One or more characters used to identify 

a statement or an item of data in a 

computer program. 
2. In assembler programming, the entry in 

the name field of an assembler language 

statement. The three main types of name 

entry are: 

a. the ordinary symbol which 
represents a label at assembly 
time. 

b. the sequence symbol which 
represents a label at pre-assembly 
time and is used as a conditional 
assembly branching destination. 

c. the variable symbol that 
represents a pre-assembly time 
label for conditional assembly 
processing and from which ordinary 
symbols can be generated tc create 
assembly-time labels. 

• language : 

1. A set of representations, conventions, 
and rules used to convey information. 

2. See machine language, object language, 
source language. 

LE: (less than or equal to) See relational 
operator. 

• length : See word length. 

length attribute (L'l ; An attribute that 
gives the number of bytes to be cccupied by 
the object code for the data represented, 
such as machine instructions, constants, or 
areas. 

length field : The operand entry or subentry 
in machine instructions that specifies the 
number of bytes at a specific address that 
are affected by the execution of the 
instruction. 

length modifier : A subfield in the operand 
of the DS or DC assembler instruction that 
determines the length in bytes of the area 
to be reserved or of the area intc which 
the data defined is to be assembled. 

• level : The degree of subordination in a 
hierarchy. 

library macro definition : A macro 
definition stored in a program library. 
The IBM-supplied supervisor and data 
management macro definitions (such as those 
called by GET or PUT) are examples of 
library macro definitions. A library macro 
definition can be included at the beginning 
of a source module: it then becomes a 
source macro definition. 



• linkage: In programming, coding that 
connects two separately coded routines. 

linkage edito r: A processing program that 
prepares the output of language translators 
for execution. It combines separately 
produced object or load modules; resolves 
symbolic cross references among them; 
replaces, deletes, and adds control 
sections, and generates overlay structures 
on request; and produces executable code (a 
load module) that is ready to be fetched 
into virtual storage. 

linkage editor control statement : An 
instruction for the linkage editor. 

literal: A symbol or a quantity in a source 
program that is itself data, rather than a 
reference to data. Contrast with figurative 
constant. 

lit eral poo l: An area in storage into which 
the assembler assembles the values of the 
literals specified in a source module. 

• load : In programming, to enter data into 
storage or working registers. 

load module : The output of the linkage 
editor; a program in a format suitable for 
loading into virtual storage for execution. 

loader : 

1. Under the Operating System (OS), a 
processing program that combines the 
basic editing and loading functions of 
the linkage editor and program fetch in 
one job step. It accepts object modules 
and load modules created by the linkage 
editor and generates executable code 
directly in virtual storage. The loader 
does not produce load modules for 
program libraries. 

2. Under the Disk Operating System (COS), 
a supervisor routine that retrieves 
program phases from the core image 
library and loads them into virtual 
storage. 

local scope : Pertaining to that part of an 
assembler program that is either the body 
of any macro definition called from a 
source module or the open code portion of 
the source module. Contrast with global 
scope. 

local variable symbol : 

1. A variable symbol that can be used to 
communicate values inside a macro 
definition or in the open code portion 
of a source module. 



^i y\ 



■C 



4 



428 






2. Contrast with global variable symbol. 

♦location ; Any place in which data iray be 
stored. 

location counter : A counter whose value 
indicates the address of data assembled 
from a machine instruction or a constant, 
or the address of an area of reserved 
storage, relative to the beginning of a , 
control section. 

• logic shift ; A shift that affects all 
positions. 

logical expression : A conditional assembly 
expression that is combination of logical 
terms, logical operators, and paired 
parentheses. 

logical operator : In assembler programming, 
an operator or pair of operators that can 
be used in a logical expression tc indicate 
the action to be performed on the terms in 
the expression. The logical operators 
allowed are: AND, OR, NOT, AND NOT, and OR 
NOT. 

logical relation : 

1. A logical term in which two expressions 
are separated by a relational operator. 
The relational operators allowed are: 
EQ, GE, GT, LE, LT, and NE. 

2. See arithmetic relation, character 
relation. 

logical term : A term that can be used only 
in a logical expression. 

loop : 
•1. A sequence of instructions that is 

executed repeatedly until a terminal 

condition prevails. 
2. See loop counter. 

loop counter : In assembler prcgramring, a 
counter to prevent excessive looping during 
conditional assembly processing. 

LT : (less than) See relational operator. 



• machine code : An operation code that a 
machine is designed to recognize. 

machine instruction : 
*T~. An instruction that a machine can 
recognize and execute. 
2. In assembler programming, (locsely) the 
symbolic machine language statements 
which the assembler translates into 
machine language instructions. 



• machine language : A language that is used 
directly by a machine. 

macro : 

1. Loosely, a macro definition. 

2. See also macro definition, macro 
generation, macro instruction, macro 
prototype statement. 

macro call : Same as macro instruction. 

macro definition : A set of assembler 
language statements that defines the name 
of, format of, and conditions for 
generating a sequence of assembler language 
statements from a single source statement. 

• macro expansion : Same as macro generation. 

macro generation : An operation in which the 
assembler produces a sequence of assembler 
language statements by processing a macro 
definition called by a macro instruction. 
Macro generation takes place at 
pre-assembly time. Synonymous with macro 
expansion. 

macro instructio n: 

1. An instruction in a source language 
that is equivalent to a specified 
sequence of machine instructions. 

2. In assembler programming, an assembler 
language statement that causes the 
assembler to process a predefined set - 
of statements (called a macro 
definition) . The statements normally 
produced from the macro definition 
replace the macro instruction in the 
source program. Synonymous with macro 
call. 

macro instruction operand : An operand that 
supplies a value to be assigned to the 
corresponding symbolic parameter of the 
macro definition called by the macro 
instruction. This value is passed into the 
macro definition to be used in its 
processing. 

macro library : See program library. 

macro processing instruction : An assembler 
instruction that is used inside macro 
definitions and processed at pre-assembly 
time. These instructions are: MACRO, MEND, 
MEXIT, and MNOTE. 

macro prototype : Same as macro prototype 
statement. 

macro prototype statement : An assembler 
language statement that is used to give a 
name to a macro definition and to provide a 
model (prototype) for the macro instruction 
that is to call the macro definition. 
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main storage : 

• 1. The general purpose storage cf a 

computer. 

Usually, main storage can be accessed 
directly by the operating registers. 
2. See also real storage, virtual storage. 

• mask ; A pattern of characters that is used 
to control the retention or elimination of 
portions of another pattern cf characters. 

mnemonic operation code ; An operation code 
consisting of mnemonic symbols that 
indicate the nature of the operation to be 
performed, the type of data used, or the 
format of the instruction performing the 
operation. 

mnemonic symbol : 

* 1. A symbol chosen to assist the human 

memory, for example, an abbreviation 
such as "mpy" for "multiply". 
2. See also mnemonic operation cede. 

model statement : A statement in the body of 
a macro definition or in open code from 
which an assembler language statement can 
be generated at pre -assembly time. Values 
can be substituted at one or more points in 
a model statement; one or more identical or 
different statements can be generated from 
the same model statement under the control 
of a conditional assembly loop. 

* module : 

1. A program unit that is discrete and 
identifiable with respect to compiling, 
combining with other units, and 
loading, for example, the input to, or 
output from, an assembler, compiler, 
linkage editor, or executive routine. 

2. See load module, object module, source 
module. 



name : 

1. A 1- to 8-character alphameric term 
that identifies a data set, a control 
statement, an instruction statement, a 
program, or a cataloged procedure. The 
first character of the name must be 
alphabetic. 

2. See entry name, external name. 

3. See also name entry, label. 

name entry : Usually synonymous with label 
(2). However, the name entry of a model 
statement can be any string cf characters 
at pre- assembly time. 

name field parameter : A symbolic parameter 
that is declared in the name field of a 
macro prototype statement. It is assigned a 



value from the entry in the name field of 
the macro instruction that corresponds to 
the macro prototype statement. 

NE : (not equal to) See relational operator. 

• nest : To imbed subroutines or data in other 
subroutines or data at a different 
hierarchical level such that the different 
levels of routines or data can be executed 
or accessed recursively. 

nesting level : In assembler programming, 
the level at which a term (or 
subexpression) appears in an expression, or 
the level at which a macro definition 
containing an inner macro instruction is 
processed by the assembler. 

• no OP : An instruction that specifically 
instructs the computer to do nothing, 
except to proceed to the next instruction 
in sequence. 

• NOT: A logic operator having the property 
that if P is a statement , then the NOT of F 
is true if P is false, false if F is true. 

• null characte r: A control character that 
serves to accomplish media fill or time 
fill, for example, in ASCII the all zeros 
character (not numeric zero) . Null 
characters may be inserted into or removed 
from a sequence of characters without 
affecting the meaning of the sequence, but 
control of equipment or the format may be 
affected. Abbreviated NUL. Contrast with 
space character. 

null character string : Same as null string. 

null strin g: 

• 1. The notion of a string depleted of its 

entities, or the notion of a string 
prior to establishing its entities. 
2. In assembler programming, synonymous 
with the null character string. 

number attribute (N*) : 

1. An attribute of a symbolic parameter 
that gives the number of sublist 
entries in the corresponding macro 
instruction operand. 

2. , An attribute that gives the number of 

positional operands in a macro 
instruction (specified as N*6SYSLIST) 
or an attribute that gives the numfcer 
of sublist entries in a specific 
positional operand (specified as 
N'SSYSLIST (n)). 



* obje c t co de: Output from an assembler which 
is itself executable machine code or is 
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suitable for processing to produce 
executable machine code. 

• object language : The language to which a 
statement is translated. The machine 
language for the IBM System/370 is an 
object language. 

• object module ; A module that is the output 
of an assembler or compiler and is input to 
a linkage editor. 

• 

• object program ; A fully compiled cr 
assembled program that is ready tc be 
loaded into the computer. Contrast with 
source program. * 

open code ; That portion cf a source module 
that lies outside of and after any source 
macro definitions that may be specified. 

open subroutine : A subroutine that is 
inserted into a routine at each place it is 
used. Contrast with closed subroutine. • 
NOTE: In assembler programming, a macro 
definition is an open subroutine, because 
the statements generated from the 
definition are inserted into the source 
module at the point of call. 

• operand ; 

1. That which is operated upon. 

2. See keyword operand, positional 
operand. 

• operating system : Software which controls 
the execution of computer programs and 
which may provide scheduling, debugging, 
input/output control, accounting, 
compilation, storage assignment, data 
management, and related services. 

• 

• operation code : A code that represents 
specific operations. 

• operator : 

1. In the description of a process, that 
which indicates the action to be 
performed on the operands . 

NOTE: In assembler programming, 
operands are referred to as terms. 

2. See arithmetic operator, binary 
operator, logical operator, unary 
operator. 

3. See also concatenation character. 

• OR: A logic operator having the property 
that if P is a statement, Q is a statement, 
R is a statement,..., then the OR of P, Q, 
R... is true if at least one statement is 
true, false if all statements are false. 

ordinary symbol : A symbol that represents 
an assembly-time value when used in the 
name or operand field of an instruction in 



the assembler language. Ordinary symbols 
are also used to represent operation codes 
for assembler language instructions. An 
ordinary symbol has one alphabetic 
character followed by zero to seven 
alphameric characters . 

outer macro instruction ; A macro 
instruction that is specified in open code. 
Contrast with inner macro instruction. 

overfl ow: That portion of the result of an 
operation that exceeds the capacity of the 
intended unit of storage. 

overlay : The technique of repeatedly using 
the same blocks of internal storage during 
different stages of a program. When one 
routine is no longer needed in storage, 
another routine can replace all part of it. 



padding : A technique used to fill a block 
with dummy data. 

paired parentheses : A left parenthesis and 
a right parenthesis that belong to the same 
level of nesting in an expression; the left 
parenthesis must appear before its matching 
right parenthesis. If parentheses are 
nested within paired parentheses, the 
nested parentheses must be paired. 

paired relocatable terms ; Two relocatable 
terms in an expression with the same 
relocatability attribute that have 
different signs after all unary operations 
have been performed. Paired relocatable 
terms have an absolute value. 

parameter ; 

1 . A variable that is given a constant 
value for a specific purpose or 
process. 

2. See keyword parameter, name field 
parameter, positional parameter, 
symbolic parameter. 

point of substitution ; Any place in an 
assembler language statement, particularly 
a model statement, into which values can be 
substituted at pre-assembly time. Variable 
symbols represent points of substitution. 

positional ope ran d ; An operand in a macro 
instruction that assigns a value to the 
corresponding positional parameter declared 
in the prototype statement of the called 
macro definition. 

positi o nal para m ete r; A symbolic parameter 
that occupies a fixed position relative to 
the other positional parameters declared in 
the same macro prototype statement. 
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pre- assembly time ; The time at which the 
assembler process macro definitions and 
performs conditional assembly operations. 

private code ; An unnamed control section. 

• program ; 

1. A series of actions proposed in order 
to achieve a certain result. 

2. Loosely, a routine. 

3. To design, write, and test a program as 
in (1). 

4. Loosely, to write a routine. 

5. See computer program, object program, 
source program. 

program fetch time ; 

1. The time at which a program (in the 
form of load modules or phases) is 
loaded into virtual storage for 
execution. 

2. See also fetch (2) , fetch (3) . 

• program library ; A collection of available 
computer programs and routines. 

programmer macro definition ; Loosely, a 
source macro definition. 



prototype statement : 
prototype statement, 



Same as mac re 



• pushdown list ; A list that is constructed 
and maintained so that the next item to be 
retrieved and removed is the most recently 
stored item in the list, that is, last in, 
first out. Synonymous with pushdown stack, 

pushdown stack ; Same as pushdown list. 



quoted string ; A character string enclosed 
by apostrophes that is used in a macro 
instruction operand to represent a value 
that can include blanks. The enclosing 
apostrophes are part of the value 
represented. Contrast with character 
expression. 



• radix ; In positional representation, that 
integer, if it exists, by which the 
significance of the digit place must be 
multiplied to give the significance of the 
next higher digit place. For example, in 
decimal notation, the radix of each place 
is ten. 

• radix complement ; A complement obtained by 
subtracting each digit from one less than 
its radix, then adding one to the least 
significant digit, executing all carries 



required. For example, tens complement in 
decimal notation, twos complement in binary 
notation. 

read-only ; A type of access to data that 
allows it to read but not modified. 

real storage ; The storage of a IBM 
System/370 computer from which the central 
processing unit can directly obtain 
instructions and data and to which it can 
directly return results. Real storage can 
occupy all or part of main storage. 
Contrast with virtual storage. 

recursive ; Pertaining to a process in which 
each step makes use of the results of 
earlier steps. 

NOTE: In assembler programming, the inner 
macro instruction that calls the macro 
definition within which it is nested 
performs a recursive call. 

• register ; 

1. A device capable of storing a specified 
amount of data such as one word. 

2. See base register, index register. 

relation ; The comparison of two expressions 
to see if the value cf one is equal to, 
less than, or greater than the value of the 
other. 

relational operator : An operator that can 
be used in an arithmetic or character 
relation to indicate the comparison to be 
performed between the terms in the 
relation. The relational operators are: EQ 
(equal) , GE (greater than or equal to) , GT 
(greater than) , LE (less to or equal to) , 
LT (less than) , NE (not equal to). 

* relative address; The number that specifies 
the difference between the absolute address 
and the base address. Synonymous with 
displacement . 

re lo catability attribute ; An attribute that 
identifies the control section to which a 
relocatable expression belongs. Two 
relocatable expressions have the same 
relocatability attribute if the unpaired 
term in each of them belongs to the same 
control section. 

relocatable expression : An assembly- time 
expression whose value is affected by 
program relocation. A relocatable 

expression can represent a relocatable 
address. 

relocatable term ; A term whose value is 
affected by program relocation. 
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» relocate ; In computer programming, to move 
a routine from one portion of storage to 
another and to adjust the necessary address 
references so that the routine, in its new 
location, can be executed. 

relocation ; The modification cf address 
constants to compensate for a change in 
origin of a module, program, or control 
section. 

• rounding ; Same as roundoff. 

roundoff ; To delete the least significant 
digit or digits of a numeral and to adjust 
the part retained in accordance with some 
rule. 

• routine ; 

1. An ordered set of instructions that may 
have some general or frequent use. 

2. See subroutine. 



scale modifier ; A subfield in the operand 
of the DC assembler instruction that 
indicates the number of digits in the 
object code to be occupied by the 
fractional portion of a fixed- point or 
floating-point constant. 

scaling attribute ; An attribute that 
indicates the number of digit positions 
occupied by the fractional portion of 
fixed-point, decimal, and floating-point 
constants in their object code forir. 

scope ; 

1. In assembler programming, that part of 
a source program in which a variable 
symbol can communicate its value. 

2. See global scope, local scope. 

self -defining term ; An absolute term whose 
value is implicit in the specification of 
the term itself. 

seguence symbol ; A symbol used as a 
branching label for conditional assembly 
instructions. It consists of a period 
followed by one to seven alphameric 
characters, the first of which must be 
alphabetic. 

SET symbol ; A variable symbol used to 
communicate values during conditional 
assembly processing. It must be declared to 
have either a global or local scope. 

severity code ; A code assigned by the 
assembler to an error detected in a source 
module. A severity code can also be 
specified and assigned to an error message 
generated by the MNOTE instruction. 



* sign bit; A binary digit occupying the sign 
position. 

sign position ; A position, normally located 
at one end of a numeral, that contains an 
indication of the algebraic sign of the 
number. 

* significant digit ; fl digit that is needed 
for a certain purpose, particularly one 
that must be kept to preserve a specific 
accuracy or precision. 

* source langua ge; The language from Which a 
statement is translated. 

source macro definition ; A macro definition 
included in a source module. A source 
macro definition can be entered into a 
program library; it then becomes a library 
macro definition. 

source module ; A sequence cf statements in 
the assembler language that constitutes the 
input to a single execution of the 
assembler. 

* source program ; A computer program written 
in a source language. Contrast with object 
program . 

* space c haracte r; A normally nonprinting 
graphic character used to separate words. 
Synonymous with blank character. Contrast 
with null character. 

* s pecial character ; A graphic character that 
is neither a letter, nor a digit, nor a 
space character. 

* statement ; 

1. In computer programming, a meaningful 
expression or generalized instruction 
in a source language. 

2. See job control statement, linkage 
editor control statement, comments 
statement, model statement. 

* storage ; 

1 . Fertaining to a device into which data 
can be entered, in which they can be 
held, and from which they can be 
retrieved at a later time. 

2. Loosely, any device that can store 
data. 

3. See main storage, real storage, virtual 
storage. 

it storage allocation ; 

1. The assignment of blocks of data to 
specified blocks of storage. 

2. See dynamic storage allocation. 
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• storage protection : An arrangement for 
preventing access to storage for either 
reading, or writing, or both. 

storage stack ; Loosely, a pushdown list. 

• string : 

1. A linear sequence of entities such as 
characters or physical elements. 

2. See bit string, character string, null 
string. 

sublis t: A macro instruction operand that 
contains one or more entries separated by 
commas and enclosed in parentheses. 

• subroutine : 

1. A routine that can be part of another 
routine. 

2. See closed subroutine, open subroutine. 

subscript : One or more elements, enclosed 
in parentheses, that appear immediately 
after a variable syirbol or character 
expression. The value of a subscript 
indicates a position in the array or string 
of values represented by the variable 
symbol or character expression. 

subscripted SSYSLIST : The system variable 
symbol SSYSLIST immediately followed by 
either one subscript or two subscripts 
separated by commas, and enclosed in 
parentheses. The value of the first 
subscript indicates the position cf a 
positional operand in a macro instruction 
and the value of the second subscript 
indicates the position of the entry in the 
sublist of the positional operand indicated 
by the first subscript. 

subscripted SET symbol : 

1. A SET symbol that is immediately 
followed by a subscript. A subscripted 
SET symbol must be declared with an 
allowable dimension before it can be 
used. The value of the subscript 
indicates the position of the value 
given to the subscripted symbol in the 
array represented by the SET symbol. 

2. See also dimensioned SET symbol. 

subscripted symbolic parameter : A symbolic 
parameter that is immediately followed by a 
subscript. The value of the subscript 
indicates the position cf the entry in the 
sublist in the macro instruction operand 
referred to by the symbolic parameter. 

substitution : The action taken by the 
assembler when it replaces a variable 
symbol with a value, for example, during 
the expansion of a macro definition. 



substring : 



1. 



A character string that has keen 
extracted from a character expression. 
2. See also substring notation. 

substring notation : A character expression 
immediately followed by two subscripts, 
separated by a comma, and enclosed in 
parentheses. It can be used only in 
conditional assembly instructions. The 
value of the first subscript indicates the 
position of the character within the 
character expression that begins the 
substring. The value of the second 
subscript represents the number of 
characters to be extracted from the 
character expression. 

• s witch : A device or programming technique 
for making a selection, for example, a 
conditional jump. 

• symbol : 

1 . A representation of something ty reason 
of relationship, association, or 
convention. 

2. See mnemonic symbol, ordinary symbol, 
sequence symbol, SET symbol, variable 
symbol. 

• symbolic address : An address expressed in 
symbols convenient to the computer 
programmer. 

• symbolic codi ng: Coding that uses machine 
instructions^with symbolic addresses. 
KCTE: In assembler programming, any 
instruction can contain symbolic addresses. 
In addition, any other portion of an 
instruction may be represented with 
symbols, for example, labels, registers, 
lengths and immediate data. 

symbolic par ameter: 

1. A variable symbol declared in the 
prototype statement of a macro 
definition. A symbolic parameter is 
usually assigned a value from the 
corresponding operand in the macro 
instruction that calls the macro 
definition. 

2. See also keyword parameter, name field 
parameter, positional parameter. 

system loader : See loader (2) . 

system macro d efinition : Loosely, a library 
macro~"definition supplied by IBM. 

system macro i nstruction: Loosely, a macro 
instruction £nat calls for the processing 
of an IBM-supplied library macro 
definition, for example, the ATTACH macro. 

system variable symbol : A variable symbol 
that always begins with the characters 



<c 



y . 



V__; 
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6SYS. The system variable symbols do not 
have to be declared, because the assembler 
assigns them read-only values automatically 
according to specific rules. 



term : 

1. The smallest part of an expression that 
can be assigned a value. 

2. See absolute term, arithmetic term, 
logical term, relocatable terir. 

• translate : To transform statements from one 
language to another without significantly 
changing the meaning. 

• truncate : To terminate a computational 
process in accordance with soire rule, for 
example, to end the evaluation of a power 
series at a specified term. 
NOTE: In assembler programming, the object 
code for data constants can be truncated by 
the assembler. 

• twos complement : The radix complement in 
binary notation. 

tvce attribute (TM : An attribute that 
distinguishes one form of data from 
another, for example, fixed-pcint constants 
from floating-point constants or machine 
instructions from macro instructions. 



unary operator : An arithmetic operator 
having only one term. The unary operators 
that can be used in absolute cr 
relocatable, and arithmetic expressions 
are: positive (♦) and negative (-) . 

unnamed control section : A control section 
that is initiated in one of the following 
three ways: 

1. By an unnamed START instruction. 

2. By an unnamed CSECT instruction, if no 
unnamed START instruction appears 
before the CSECT instruction. 

3. By any instruction that affects the 
setting of the location counter. 



* variable : A quantity that can assume any of 
a given set of values. 

va r iable s ymbo l : In assembler programming, 
a symbol, used in macro and conditional 
assembly processing, that can assume any of 
a given set of values. It consists of an 
ampersand (S) followed by one to seven 
alphameric characters, the first of which 
must be alphabetic. 

NOTE: All variable symbols must be declared 
except the system variable symbols. 

virtual sto ra ge: Address space appearing to 
the user as real storage from which 
instructions and data are mapped into real 
storage locations. The size of virtual 
storage is limited only by the addressing 
scheme of the computing system rather than 
by the actual number cf real storage 
locations. Contrast with real storage. 



warning message : An indication that a 
possible error has been detected. The 
assembler does not assign a severity code 
to this type of error. Contrast with error 
message. 

word : 

* 1. A character string or bit string 

considered as an entity. 

* 2. See computer word. 

3. See doubleword, fullword, half word. 

* word length : A measure of the size of a 
word, usually specified in units such as 
characters or binary digits. 

NOTE: In assembler programming, the word, 
or fullword, contains 32 bits (binary 
digits) or h bytes. 

wrap-around : Loosely, the overflow of the 
location counter when the value assigned to 
it exceeds 22* -i 
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(see period) 
+ (see plus sign) 
£ (see ampersand) 
SSYSDATE (system variable symbol) 279 

attributes of 279,325 

global scope of 279 
6SYSECT (system variable symbol) 280 

attributes of 280,325 

local scope of 279 

in nested macros 316 
6SYSLIST (system variable symbol) 281 

attributes of 283,325 

local scope of 279 

in nested macros 314 

notation allowed 281 

number attribute of 283 

subscripts for 281,282 
6SYSNDX (system variable symbol) 284 

attributes of 284,325 

local scope of 279 

in nested macros 315 
6SYSPARM (system variable symbol) 284 

attributes of 285,325 

global scope of 279 

specified in job control 
language 285 
I under CMS 285-286 

6SYSTIME (system variable symbol) 286 
I attributes of 287,325 

global scope of 279 
$ (see dollar sign) 

* (see asterisk) 
(see minus sign) 

/ (see slash) 
, (see comma) 

# (see number sign) 
S) (see at sign) 

• (see apostrophe) 
= (see equal sign) 
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absolute address 84 
absolute expression 57,56 
A-con (see address constant, 

A- type) 
ACTR instruction 370 
address 

absolute 84 

base 85,133 

base displacement format of 86 

definition 84 

explicit 87 

implicit 87 

reference 84 

relocatable 84 

relocatability of 85 
address constant 



A- type 194 

location counter 

reference in 194 
defined by DC instruction 162 
External Symbol Dictionary 

entry for 116 
location counter reference in 
Q-type 200 

for external dummy section 
S-type 196 
V-type 198 
Y-type 194 

location counter 
reference in 194 
address reference 84 

(see also explicit address; 
implicit address; symbolic 
address) 
addressing 

between source modules 147 
within source modules 133 
AGO instruction 369 
AIF instruction 367 
alignment 75 

ALIGN option 75 
boundary 76,166 
of constants and areas 166,76 
forcing of 204,76 
of machine instructions 75 
ALIGN option 75,204 
ALOGIC option 376 
alphabetic character 
of character set 34 
in symbols 37,35 
alphameric (see character) 
alternate statement format 
for macro instruction 

statement 291 
for macro prototype statement 256 
number of continuation lines 
allowed 18 
ampersand (€) 35 

(see also double ampersand) 
as variable symbol indicator 
AND operator 361 
ANOP instruction 373 
apostrophe (•) 

(see also double apostrophe) 
in attribute notation 324 
to delimit character strings 35 
to delimit quoted strings 304 
area (see data area) 
arithmetic expression 349 
arithmetic operator 
binary operator 

addition (♦) 55,351 
division (/) 55,351 
multiplication (*) 55,351 
subtraction (-) 55,351 
unary operator 

negative (-) 55,351 
positive (♦) 55,351 
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arithmetic relation 361 
arithmetic term 

attribute reference 55,351 
self-defining 46 
SET symbol 318,351 
symbolic parameter 260,351 
system variable symbol 278,351 
array 

dimensioned SET symbol 322 
assembler instruction 30 

conditional assembly 32,317 
macro processing 32 
ordinary 30 

addressing 133 
controlling the assembler 

program 211 
program sectioning 101 
symbol and data definition 153 
assembler language 2 
character set 34 
comments statement 19 
expressions 53 

(see also expression) 
assembly time 54,6 
conditional assembly 349 
instruction statement 20 

assembler instructions 99,407 
machine instructions 63 
macro instructions 244,289 
literals 50 
option 

ALIGN 75 
ALOGIC 376 
FLAG 274 
LIBMAC 286 
MCALL 287 
MLOGIC 376 
program 3 

source module 26,102 
statement coding 15 
structure 25 
terms 36 
assembler processing sequence 4 
assembly time 6 
pre- assembly time 7,8 
assembly time 

assembly into object code 5,108 
expression 54,6 
absolute 57 
complex relocatable 58 
instructions processed during 5,6 
assignment instructions 
arithmetic 343 
character 345 
logical 347 
asterisk (*) 

(see also binary operator) 
as comments statement 

indicator 19 
as location counter reference 

indicator 43 
as multiplication operator 55,351 
with period, as internal macro 
comments statement indicator 277 
at sign (fl) 

as alphabetic character 34 
attribute 

(see also relocatability 
attribute) 



count (K») 332 

integer (I*) 331 

length (L*) 329 

notation 324 

number (N*) 333 

reference 324 

scaling (S*) 330 

symbol length 44 

type (T") 328 

in character relation 361 
in SETC operand 345 
attribute notation 324 
attribute reference 

(see attribute) 
assembler processing sequence 4 

assembler instructions 6,7 

machine instructions 5 

macro instructions 8 



B-con (see data constant, binary) 
base address 85 

assigned by USING 134 
base-displacement form 84 

allowing relocatability of 
addresses 85 

assembled into machine 
instruction 86 

converted from implicit 
address 87,134 
base register 

assigned by USING 134 

loading 134 
begin column 16 
binary constant (B) 181 
binary operator (♦,-,*,/) 

in absolute and relocatable 
expressions 55 

in arithmetic expressions 351,353 
bit string 

in binary self-defining term 48 
bit-length modifier 8,172 
blank 

character 35 

in operands 22 

opposed to null character 
string 298 

in self-defining term 50 

as special character 34 
Bool£an 

expression (see logical 
expression) 

operator (see logical 
operator) 
boundary (see also alignment) 166 
boundary alignment (see 

alignment) 
branching 

conditional assembly 367 

extended mnemonic for 72 

machine instruction for 68 
buffer area 

formatted by a dummy section 121 
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C-con (see data constant, 

character) 
call (see macro instruction) 
card (see punched card) 
card deck (see deck) 
CCW instruction 209 
central processing unit 4 
channel command word 209 
character 

alphameric (alphanumeric) 34 

digit 34 

expression 355 

letter 34 

relation 360 

set 34 

special 34 

string, null 298,303 
character constant (C) 182 
character expression 355 

concatenation operator 281 
between 357,359 

in SETC operand 345 

in substring notation 365 
character relation 

in logical expression 361,363 
character set 34,35 
character string 

(see also null character 
string) 

character constant (Otype) 182 

in character relations 360,361 

character self-defining term 50 

concatenation of character 
strings 359,268 

in macro instruction operands 302 

in MNOTE instruction 274 

in PUNCH instruction 229 

SETC operand 345 

in TITLE instruction 226 

type attribute 327 
CNOP instruction 218 
code 

condition 391 

machine 1 

mnemonic 79 

object 2 

open 252 

operation 22,79 

source 2 
coding 

conventions 15 

form 15 

time 4-8,108 
column 

begin 16 

continuation- indicator 16 

continue 16 

end 16 
COM instruction 124 

to continue common section 124 

to initiate common section 124 
comma (,) 35 

in character constants 182 



to indicate omitted 
operand field 80 
subfield 81 
between nominal values in 

constants 179 
between operands 35 
command 

(see channel command word) 
comments statement 19,27 
format 19,27 
in macro definitions 277 
common control section 

COM instruction for 124 
definition of 124 

establishing addressability of 124 
complex relocatable expression 58 
only in A- type and Y-type 
address constants 194,58 
concatenation character (.) 

between character expressions 359 
in model statements 268 
concatenation operator (see 

concatenation character) 
condition code 391 
conditional assembly 

branching instructions 
ACTR 370 
AGO 3 69 
AIF 367 
ANOP 373 
elements 317 

data attributes 323 
sequence symbol 334 
SET symbols 318 
expression 349 

arithmetic 349 
character 355 
logical 359 
functions of 318 
instructions 
ACTR 370 
AGO 369 
AIF 367 
ANOP 373 

GBLA, GBLB, GBLC 340 
LCLA, LCLB, LCLC 336 
SETA 343 
SETB 347 
SETC 345 
loop counter 370,372 
in open code 374 
pre- assembly time 374,7 
processing 7 

substring notation in 364 
constant 

address 194-200 
data 154,161 

defined by DC instruction 161 
duplication factor subfield 168,163 
literal 180 

modifier subfield 163,170 
nominal value subfield 163,179 
padding of value 167 
truncation of value 168 
type subfield 163,169 
continue column 16 
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continuation 

indicator field 17 
line 9,18 
control program 107 
control section 107 
common 124 
dummy 121 

executable, defined by 
CSECT 110,119 
START 110,117 
external symbol dictionary 
entries for 116 
first 113 

literal pools in 115 
location counter setting 111 
processing times 108 
reference, defined by 
COM 110,124 
DSECT 110,121 
DXD 110,130 
unnamed 115 
COPY instruction 103 

input to source module 102 
inside macro definitions 272 
counter 

instruction 41 
location 41,111 

(see also location 
counter) 
loop 

ACTR instruction 370 
count attribute (K*) 332 
CPU (see central processing unit) 
CSECT instruction 119 

to continue control section 119,120 
external symbol dictionary 

entry for 116 
to initiate executable control 
section 119,120 
CXD instruction 131 

cumulative length of external 

dummy sections 131,128 
for linkage editor 131,128 
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D-con (see floating point 

constant, long) 
data 

area 154,201 

attribute 323 

constant 154,162 
data attribute (see attribute) 
data constant 

binary (B) 181 

character (C) 182 

decimal (P,Z) 188 

defined by DC instruction 162 

fixed- point (H,F) 186 

floating-point (E,D,L) 190 

hexadecimal (X) 184 
data definition 154,161 
DC instruction 

defining data 162 

operand 163 



subfields in operand 16 3 

arithmetic 65 

constants (P and Z) 188 

instructions 65 

self-defining term 47 
decimal constant 

integer attribute of 331 

packed (P) 188 

scaling attribute of 330 

zoned (Z) 188 
decimal point (.) 

for decimal arithmetic 65 

in decimal (P,Z) constants 188 

for fixed- point arithmetic 64 

in fixed- point (H,F) constants 187,176 

for floating-point arithmetic 66 

in floating-point (E,D,L) 
constants 191,178 
deck 

object 1 

source 1 
declaration instructions 

global 340 

local 336 
dictionary, external symbol 116,150 
dimensioned SET symbol 

declaration of 339,342 
displacement 

assembled into machine 
instruction 86 

computed from base address 87,133 
dollar sign ($) 

as alphabetical character 34 
double ampersand 

in character expression 357 

in MNOTE instruction 274 

in PUNCH instruction 230 

in TITLE instruction 226 
double apostrophe 

in character expression 357 

in MNOTE instruction 274 

in PUNCH instruction 230 

in TITLE instruction 226 
doubleword 

boundary 166 

data constants 166,191 
DROP instruction 144 

for freeing base registers 144 

not needed 146 

with USING 145,146 
DS instruction 201 

defining areas 201 

operand 206 

subfields in operand 206 

with duplication factor 204,76 
DSECT instruction 121 

to continue dummy section 121 

external symbol dictionary 
entry for 116 

to generate external dummy 
section 127 

to initiate dummy section 121 

name in Q-type address 
constant 127,200 

with USING 140 
dummy control section 

definition of 121 

DSECT instruction for 121 
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DXD instruction for 130 
establishing addressability of 
opposed to external dummy 

section 130 
duplication factor 

in SETC operand 346 
subfield of DC/DS operand 168 
1DXD instruction 130 

external symbol dictionary 

entry for 116 
to generate external dummy 

section 127 
name in Q-type address 

constant 200 



121,140 



EBCDIC (see extended binary coded 
decimal interchange code) 377 
E-con (see floating-point 

constant, short) 
EJECT instruction 227 
end column 16 
END instruction 105 

to end source module 102 
multiple 103 
entry symbol 

identified by ENTRY 150 
entry (see instruction statement 
entry; external symbol 
dictionary, entries) 
ENTRY instruction 150 

external symbol dictionary 

entry for 150,116 
identifying entry symbol 150 
for symbolic linkage 147 
EQ — equal to 360 

(see also relational operator) 
I EQU instruction 156 
equal sign (=) 

to indicate literal 53, 180 
in macro instruction operand 306 
BSD (see external symbol 

dictionary) 
establishing addressability 133 
of common section 124 
of dummy section 121,140 
of executable control section 120,137 
of external dummy section 128 
of large control section 138 
of reference control section 140 
excess- 64 binary notation 

for exponent in floating-point 
constant 193 
executable control section 110 

establishing addressability of 137 
initiated by CSECT 119 
initiated by START 117 
execution time 4-8,108 
explicit address 

(see also base-displacement 
form) 
converted from implicit 

address 87,134 
in machine instruction 87 



exponent 

in excess- 64 binary notation 193 
modifier 170,178 
in nominal value of constant 179 
portion of floating-point 
constant 192 
expression 

(see also assembly time 
expression; conditional 
assembly expression) 
absolute 57 
arithmetic 349 
Boolean (see expression, 

logical) 
character 355 
complex relocatable 58 
logical 359 

arithmetic relation in 361 
character relation in 361 
operators 

arithmetic 55,351 
concatenation 357 
logical 361 
relocatable 58 
terms in 

arithmetic 351 
logical 361 
extended floating-point constant 190 
extended mnemonic branching 

instruction 72,73 
external dummy control section 
allocation of storage for 127 
CXD instruction for 131 
DSECT instruction for 127 
DXD instruction for 130 
establishing addressability of 128 
generation of 127 
offset to 127 
external symbol 

identified by EXTRN 151 
identified in V-type address 

constant 149,198 
identified by WXTRN 152 
external symbol dictionary 116 

entries for 150,151 
EXTRN instruction 151 

for data reference 148 
external symbol dictionary 

entry for 151 
identifying external symbol 151 
opposed to V-type address 

constant 149 
opposed to WXTRN instruction 152 
for symbolic linkage 147 



F-con (see fixed-point constant, 
fullword) 

fetch (see program fetch time) 

first control section 
initiated by 113 
literal pool in 115,216 
statements allowed before 114 
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331 



330 



fixed-point 

arithmetic 64 

constant 186 

instruction 64 
fixed-point constant 

exponent modifier 

fullword (F) 186 

half word (H) 186 

integer attribute of 

scale modifier 176 

scaling attribute of 
FLAG option 274 
floating- point 

arithmetic 66 

constant 190 

instruction 66 
floating-point constant 

base for 

exponent 

excess-64 binary notation 

for 193 
modifier 178 
in nominal value 179 

extended precision (L) 190 

fractional portion 192 

integer attribute of 331 

long (D) 190 

scale modifier 178 

scaling attribute of 330 

short (E) 190 
format 

machine language 78,92 

source statement 20 
formatting 

COM instruction for 124 

data area using dummy section 

DSECT instruction for 121 
fraction 

in fixed-point constants 186 

in floating-point constants 192 

scale modifier to provide 
digits for 175-178 

scaling attribute to indicate 330 
number of digits occupied by 
fraction bar (/ — see slash) 
fractional portion 

of floating-point constants 192 
fullword 

boundary (see boundary) 

constant 186 



121 



GBLA instruction 340 
GBLB instruction 340 
GBLC instruction 340 
GE — greater than or equal to 360 

(see also relational operator) 
generation (see macro generation) 
global 

(see also global scope, global 
variable symbol) 

declaration 340 
global scope 

of SET symbol 319 

of system variable symbols 



6SYSDATE 279 
6SYSPARM 284 
6SYSTIME 287 
global variable symbol 
SET symbol 319 
system variable symbols 
SSYSDATE 279 
6SYSPARM 284 
6SYSTIME 287 
GT — greater than 360 

(see also relational operator) 



^ 



H-con (see fixed-point constant, 

ha If word) 
ha If word 

boundary (see boundary) 

constant 186 

instructions 
hexadecimal 

constant (X) 184 

digit 49 

notation in floating-point 
constants 193 

self-defining term 49 
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I' (see integer attribute) 
ICTL instruction 219 
identification- sequence field 17 
immediate data 90 
implicit address 

converted to explicit address 87,134 

in machine instruction 87 

in USING domain 125 
index register 

in address reference 86 

in machine instruction operand 87 
inner macro instruction 307 
input 

to assembler program 2,102 

buffer 121 

to linkage editor 2,108 

to source module 102 
input/output instructions 70 
instruction 

assembler 3,30 

conditional assembly 32,317 

entry 2 1 

format (see machine 
instruction format) 

machine 2,29 

macro 33,289 

statement 16 

statement format 20 
instruction counter 41 
instruction entry (see 

instruction statement entry) 
instruction statement 2,26 
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instruction statement entry 

name 21 

operand 22 

operation 22 

remarks 2 3 
instruction statement format 
integer attribute (I*) 331 

formula for 331 
I/O (see input/output) 
ISEQ instruction 221 



20 



K* (see count attribute) 
keyword operand 296 

combining with positional 
parameters 299 
keyword parameter 263 

combining with positional 
parameters 265 
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L* (see length attribute) 
label 

ordinary symbol as 38 

sequence symbol as 335 

variable symbol as 344,345,348 
language (see assembler language) 
LCLA instruction 336 
LCLfi instruction 336 
LCLC instruction 336 
L-con (see floating-point 

constant, extended precision) 
LE — less than or equal to 360 

(see also relational operator) 
length 

attribute 329 

explicit 88 

implicit 88 
I modifier 159 
length attribute (L 1 ) 329 

in arithmetic expression 351 

in assembler language 
statement 45 
j assembly time 158,159 
I pre- assembly time 158,159 

value 
length field 

in machine instructions 88 

length modifier 170 

letter 34 

level (see nesting level) 
LIBMAC option 286 
library 

macro definition 252 

for statement to be copied 103 
library macro definition 

IBM supplied 239 

opposed to source macro 
definition 252 



printing of (option LIBMAC) 287 
linkage (see linkage edit 
processing) 
linkage edit processing 
control sections 108 
ESD entries for 116 
external dummy section 
CXD instruction 131 
Q-type address constant 200 
load module 1,108 
object module 1,108 
symbolic linkage information 
ENTRY 150 
EXTRN 151 

V-type address constant 198 
WXTRN 152 
linkage-edit time 4-8,108 
linkage editor 

address constants for 
A- type 194 
Q-type 200 
V-type 198 
Y-type 194 
control statement 

created by PUNCH 228 
created by REPRO 231 
external symbol dictionary 116 
instruction for 
CXD 131 
listing control instructions 
EJECT 227 
PRINT 222 
SPACE 228 
TITLE 224 
listing options 
ALOGIC 376 
LIBMAC 286 
MCALL 287 
MLOGIC 376 
literal 50 

compared to data constants 

and self- defining terms 51 
constant 180 
duplicate 217 
pool 51,215 
specification 53 
subfields 53 
literal pool 215 

in control section 115 
initiated by LTORG 215 
load 

instruction 

fixed- point arithmetic 64 
floating-point arithmetic 66 
logical operations 67 
module 2,108 

time (see program fetch time) 
load module 

combined from object modules 2,108 
loaded by loader 4 
loaded at program fetch time 4,108 
produced by linkage editor 2,108 
load time (see program fetch 
time) 
loader 4 
local 

(see also local scope, local 
variable symbol) 
declaration 336 
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local scope 

of ACTR instruction 371 
of sequence symbol 325 
of SET symbol 319 
of symbolic parameter 260,319 
of system variable symbols 
6SYSECT 319 
SSYSLIST 319 
6SYSNDX 319 
local variable symbol 
SET symbol 318 

declaration of 336 
symbolic parameter 260 
system variable symbols 
SSYSECT 280 
SSYSLIST 281 
6SYSNDX 28 U 
location counter 41 
printed values 42 
setting for control sections 111 
location counter reference (*) 41 
in address constants (A and 

Y-type) 194 
in expressions 55 
in literals 43 
in ORG operand 213 
logical expression 359 
in AIF operand 367 
coding rules for 362 
definition of 361 
evaluation of 363 
operators for 361 
in SETB operand 340 
terms in 361 
logical operator 

AND, NOT, OR 361 
in logical expression 361 
logical relation 

(see also arithmetic relation, 
character relation) 
in logical expression 360 
operators for 360 

(see also relational 
operator) 
logical term 

in logical expression 361 
loop 

conditional assembly 370 
counter 370 
loop counter 370 

ACTR instruction for 370 
LT — less than 360 

(see also relational operator) 
LTORG instruction 214 
for literal pool 215 



machine instruction 

address in 84 

explicit 87,133 
implicit 87,133 

alignment of 75 

coding examples 92 

format of 78 

immediate data in 90 



mnemonic operation code for 79 
object code from 78,92-97 
operand entry 80 
processing 5 
register usage in 83 
statement format 29,78 
types 64-74 
machine instruction format 
RR 92 
RS 94 
RX 93 
S 96 
SI 95 
SS 97 
machine language 1 
macro (see macro definition, 

macro instruction) 
MACRO assembler instruction 254 
(see also macro definition, 
header) 
macro call (see macro 

instruction) 
macro definition 245,251 
body of 248,259 
format 253 
header (MACRO) 254 
internal comments for 277 
library macro definition 246,252 

printing of (LIBMAC) 287 
as opposed to open code 252 
prototype statement of 243,255 
source macro definition 246,252 
statements in 

comments statements 248,277 
model statements 248,266 
processing statements 249,272 
symbolic parameters in 260 
trailer (MEND) 254 
where to specify 246,252 
macro expansion 240 

(see also macro generation) 
macro generation 240 
of comments 277 
controlled by conditional 

assembly language 242,317 
message produced by MNOTE 274,275 
model statement for 248,266 
of operation codes 270 
output from macro definition 240-242 
at pre- assembly time 
macro instruction 33,289 

alternate statement format 291 
call to a macro definition 240 
entry 

name 292 
operand 293 
operation 293 
format of 290 
inner 307 
nesting of 247,307 

levels 308 
operand 294 

SSYSLIST 281,301 
keyword 296 
positional 294 
sublist 300 
outer 307 
I printing of nested (MCALL) 288 
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processing 8 

recursive call 310 

statement format 290 

values in operands 302 

where to specify 247,290 
macro instruction operand 

combining keyword and 
positional 299 

keyword 296 

positional 294 

sublist as value 300 

value of 302 
macro library 246,252 

macro definition in 246 
macro prototype statement 255 

alternate format 256 

entry 

name 256 
operand 258 
operation 257 

format of 255 

name field parameter in 257 

symbolic parameters in 258,260 
keyword 263 
positional 262 
mask 

for branching 90 

as immediate data 92,94 
MCALL option 287 
MEND instruction 254 

(see also macro definition, 
trailer) 

as exit from macro definitions 249 
MEXIT instruction 276 
minus sign (-) 

(see also binary operator, 
unary operator) 

as subtraction operator 355,351 
MLOGIC option 376 
mnemonic operation code 

changing of (OPSYN) 232 

creating of, for macros 257 

generation of 270 

for machine instructions 79 

naming a macro definition 243,257 

structure of 79 

used in macro instruction to 
call a macro definition 243 
MNOTE instruction 273 
model statement 266 

concatenation in 268 

fields in 267 

format of 266 

points of substitution in 267 

rules for field contents 269 

variable symbols in 267 
modifier 

exponent 178 
bit- length 172 
length 170 
scale 175 

subfield in DC/DS operand 170 
module (see load module, object 
module, source module) 



N* (see number attribute) 
name entry 

in assembler language 
instruction 21 

in conditional assembly 
instruction 32 
| in EQU instruction 156,160 

in machine instruction 29 

in macro instruction 292 

in macro prototype statement 256 

in model statement 269 

in OPSYN instruction 232 

in TITLE instruction 224 
name field parameter 

assigning a value to 292 

of macro prototype statement 256 

opposed to symbolic parameter 256,257 
NE — not equal to 

(see relational operator) 
nested macro instruction 247,307 
nesting level 

for COPY instructions 104 

for macro instructions 308 
no op (see no operation 

instruction) 
no operation instruction 

extended mnemonic for 73 

generated by CNOP instruction 218 
NO ALIGN (opposite of ALIGN) 6 
NOALOGIC (opposite of ALOGIC) 
NOLIBMAC (opposite of LIBMAC) 
NOMCALL (opposite of MCALL) 
nominal value 

subfield in DC/DS operand 179 
NOMLOGIC (opposite of MLOGIC) 
NOT operator 361 
notation (see attribute notation, 
excess- 6 4 binary notation, 
substring notation) 
null character string 

as default value of keyword 
parameter 264,298 

generation of 298,303 

in model statement 298,303 

opposed to blank 298 

as sublist entry 301 

as value in macro instruction 
operand 303 
number attribute (N") 333 

Of SSYSLIST 283 

in arithmetic expression 351 
number representation 

for decimal constants 188 

for floating-point constants 192 
number sign (#) 

as alphabetic character 34 
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object code 

of addresses 86 

of channel command words (CCW) 210 
of data constants (DC) 
padding 167 
truncation 168 
entered into 

common control section 124 
external dummy control 
section 128 
formats for machine 

instructions 78 
of lengths 

effective 88 
explicit 88 
implicit 88 
of machine instructions 92-97 

alignment 75 
registers assembled into 83 
registers not apparent in 83 
representation of decimal 

constants 188 
representation of floating- 
point constants 193 

(see also excess-64 binary 
notation) 
fraction 193 
exponent 193 
object language (see object code) 
object module 

area reserved in, by DS 201 
assembled from source module 2,108 
automatic call for (EXTRN) 152 
combined into load module 2,108 
common control section in 124 
constant assembled into, from 
| DC instruction 161 

as opposed to source module 101 
open code 

conditional assembly in 374 
opposed to code inside macro 
definitions 252 
operand 

(see also operand entry, term) 
alternate format for 256,291 
combined with remarks in 

model statement 271 
combining keyword and 

positional 299 
in DC/DS instruction 163,206 
entry in assembler language 

instruction 22 
field 20 
format of 22,80 
keyword 296 

of macro definition 258 
of macro instruction 294 
positional 294 

subfield in DC/DS instruction 163,206 
symbolic parameter as 258,260 
operand entry 22 
address 84 

in assembler instruction 31 
combined with remarks in 
model statement 271 



in conditional assembly 
instruction 32 

immediate data 90 

length 88 

in machine instruction 29 

in macro instruction 33,293 

in macro prototype instruction 258 

in model statement 271 

register 82 
operation code (see mnemonic 

operation code) 
operation entry 22 

in assembler instruction 21 

in conditional assembly 
instruction 32 

in machine instruction 29 

in macro instruction 29 3 

in macro prototype statement 257 

in model statement 270 
operator 

arithmetic 

binary 55,351 
unary 55,351 

concatenation (see 
concatenation character) 

logical 361 

relational 360 
OPSYN instruction 232 
option (see assembler, option) 
OR operator 361 
ordinary symbol 37 

as operation code for macro 
prototype statement 257 

opposed to sequence symbol, 
variable symbol 37,38 
ORG instruction 212 
outer macro instruction 307 
output 

from assembler program 2,108 

buffer 121 

from linkage editor 2,108 

from source module 2,108 
overflow 

of location counter 42 
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padding of constants 167 
paired relocatable terms 56 
in absolute and relocatable 
, expressions 57,58 
from dummy section, allowed in 
address constants 123 
parameter 

name field 256 
symbolic 260 
P-con (see decimal constant, 

packed) 
period (.) 

(see also concatention 
character, decimal point) 
with asterisk as internal 
macro comments statement 
indicator 19,277 
as bit- length indicator 172 
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in macro instruction operand 

value 307 
as sequence symbol indicator 38,334 
plus sign (+) 

(see also binary operator, 
unary operator) 
as addition operator 55,351 
point of substitution 

in model statement 269-271 
variable symbol as 261 
POP instruction 23U 
position 

of character in line after 

REPRO 231 
of character in PUNCH operand 
corresponding to coding sheet 
column 1 5 
positional operand 294 
combining with keyword 

operands 299 
in macro instruction 29 4 
positional parameter 262 
combining with keyword 
parameters 265 
pre- assembly time 4-8 
expression 

arithmetic 349 
character 355 
logical 359 
instructions processed during 7 
operation 
precision 

extended, floating-point 
constant (L-con) 190 
PRINT instruction 222 
private code 115 

(see also unnamed control 
section) 
processing sequence 

(see processing time) 
processing statements in macro 
definitions 272 

conditional assembly 

instructions 272-317 
COPY instruction 272 
inner macro instruction 272-30 7 
MEXIT 276 
MNOTE 273 
processing time 

(see also assembler processing 
sequence) 
assembly 4-8,108 
coding 4-8,108 
execution 4-8,108 
linkage edit 4-8,108 
pre- assembly 4-8 
program fetch 4-8,108 
program 

(see also object program, 
source program) 
execution 108 
linkage 101,108 
sectioning 101 
program fetch time 4,108 
program library (see library) 



program relocation 

effect on absolute terms 36 
effect on address references 
effect on relocatable terms 
programmer macro 

(see source macro definition) 
prototype statement (see macro 

prototype statement) 
PUNCH instruction 228 
punched card 

containing assembler language 

statements 1,15 
as input to assembler 102 
PUSH instruction 234 
pushdown list 234 

(see also in GLOSSARY) 
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Q-con (see address constant, 

Q-type) 
quoted string 30 4 



read-only storage (see literal 

pool) 
read-only value 

of literals 53 

of symbolic parameters 260 

of system variable symbols 270 
recursion 

of nested macro calls 310 
reference control section 110 

common section 124 

dummy section 121 

establishing addressability of 140 

external dummy section 127 

initiated by COM 124 

initiated by DSECT 21 

initiated by DXD 130 
register 82 

base 85,133 

index 86 

as operand in machine 
instruction 82 

usage in machine instruction 
operations 83 
relation (see arithmetic 
relation, character relation, 
logical relation) 
relational operator (EQ, GE, GT, 
LE, and NF) 360 

between arithmetic expressions 361 

between character strings 361 
relative address (see 

displacement) 
relocat ability 

of addresses 85 

attribute 58 
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relocatable address 84 
relocatable expression 58,56 

complex relocatable 
expression 58 

processed at assembly time 6 
relocatable term 36 
relocate 

(see also program relocation) 

instructions 74 
REPRO instruction 231 
rounding 

of fixed-point constants 177 

of floating-point constants 178 
RR format 92 
RS format 94 
RX format 93 



S format 96 

S' (see scaling attribute) 

SI format 95 
SS format 97 
scale modifier 

for fixed- point constants 176 

for floating-point constants 178 
scaling attribute (S 1 ) 330 

in formula for integer 
attribute 331 
S-con (see address constant, 

S-type) 
scope (see global scope, local 

scope) 
self-defining term 46 

in assembly-time expressions 55 

binary 48 

character 50 

in conditional assembly 
expressions 351,361 

decimal 47 

in EQU operands 156-160 

hexadecimal 49 
sequence symbol 38 

as conditional assembly label 334 

format of 334 

local scope of 35 
SET symbol 318 

in arithmetic expression 349 

assigning value to 349 

in character expression 356 

declaration of 336 

in logical expression 361 

scope of 319 

as subscript 318 

subscripted 322 
SETA instruction 343 
SETB instruction 347 
SETC instruction 345 
severity code 

in MNOTE operand 273 
sign 

(see also sign bit) 

for decimal numbers 188 

for fixed- point numbers 186 

for floating-point numbers 190 



sign bit 

in fixed-point constants 186 
in floating-point constants 192 
in self-defining terms 47-49 
slash (/) 

(see also binary operator) 
as division operator 55,351 
source language (see assembler 

language) 
source macro definition 

opposed to library macro 

definition 252 
where to specify in source 
module 246,252 
source module 26,102 

addressing within (USING) 133 

assembled into object module 101 

beginning of 102 

control sections in 101 

copying statements into (COPY) 103 

end of (END) 102 

input to assembler program 10 2 

literals in 214 

number of external symbol 

dictionary entries allowed in 116 
open code of 252 
as opposed to object module 101 
size of 101 

source macro definition in 246,252 
statements in 

comments 27,19 
instruction 26,20 
structure of 26 
symbolic linkage between 147 
source program 101 
SPACE instruction 228 
special character 34 

before attribute notation 305 
between operator and term 362 
START instruction 117 

external symbol dictionary 

entry for 116 
to initiate first (executable) 

control section 113 
statements allowed before 113,114 
statement 

assembler language 2, 15 
comments 19 
field 16 
format 

fixed 20 
free 20 
instruction 20 
macro prototype 255 
model 266,8 
status switching instructions 69 
storage (see virtual storage, 

pushdown list) 
storage allocation 

for external dummy sections 128 
store 

not allowed with literal 53 
operation 
string (see bit string, character 

string) 
sublist 

in macro instruction operand 300 
in nested macros 312,313 
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referred to by 

subscripted SSYSLIST 300,281 
subscripted parameter 300,261 
subscript 

in SSYSLIST notation 281 
to indicate sublist entry 261,281 
nesting of 322 
for parameter 261 
| for SET symbol 322 

in substring notation 365 
for variable 267 
subscripted SSYSLIST 
in nested macros 314 
reference to positional 

operand 281,282 
reference to sublist entry 281,282 
subscripts for 282 
subscripted character expression 

(see substring notation) 
subscripted parameter 261 
in nested macros 312,313 
reference to sublist entry 261 
subscript for 261 
subscripted SET symbol 318,322 
nesting of subscripts 322 
for SETA symbols 344 
for SETB symbols 348 
for SETC symbols 347 
subscripted variable symbol 267 
(see also subscripted 
SSYSLIST, subscripted 
character expression, 
subscripted parameter, 
subscripted SET symbol) 
substitution 

point of 267 
at pre-assembly time 7,8 
substring notation 364 

character expression in 366 
concatenated to character 

expression 359 
in SETC operand 345 
subscripts for 366 
suppression (see zero 

suppression) 
symbol 

definition of 38 
entry 1 50 
external 151 

dictionary (ESD) 116 
length attribute reference 44 
ordinary 37 
previously defined 40 
sequence 38,334 
system variable symbol 278 
table 37 
variable 38 
SET 318 

symbolic parameter 260 
symbol definition 

in assembler language 

instruction 38 
mnemonic operation code by 

OPSYN 232 
using EQU instruction 155 
symbol length attribute reference 44 

(see also attribute) 
symbolic address reference 84 



symbolic linkage 147 
symbolic parameter 260 
attributes of 325,327 
in body of macro definition 260,267 
as macro instruction operand 

value 311,312 
in macro prototype statement 

operand 255,200 
in model statement 266,267 
in nested macro instruction 311-313 
opposed to name field 
parameter 256,292 
symbolic representation 36,153 
system macro 

(see library macro definition) 
system variable symbol 278 
6 SYS DATE 279 
6SYSECT 280 
SSYSLIST 281 
SSYSNDX 284 
SSYSPARM 284 
| SSYSTIME 287 



T* (see type attribute) 
term (sometimes called operand) 
absolute 36 

ordinary symbol 37 
self-defining 46 
symbol length attribute 
reference 44 
arithmetic 

attribute reference 46,351 
self-defining 46,351 
variable symbol 38,352 
logical 361 
relocatable 

location counter reference 41 
ordinary symbol 27 
terminal 

to enter statements 1 
input to the assembler 102 
TITLE instruction 224 
translation (see assembly) 
truncation of constants 168 
type attribute (T 1 ) 328 

in logical expression 361 
in SETC operand 345 
value 328 
type subfield in DC/DS operand 169 
twos complement 

representation for negative 
numbers 188 



unary operator (+ ,-) 

in absolute and relocatable 

expressions 55 
in arithmetic expressions j5 1,353 
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unnamed control section 115 

external symbol dictionary 
entry for 116 

initiation of 115 
USING domain 

address reference within 135 

corresponding USING range 135 

definition of 135 

rules for 141 
USING instruction 134-144 

for assigning base address 134 

for assigning base registers 134 

domain of 135 

for establishing 
addressability 134,137 

range of 135 
USING range 

address within 135 

corresponding USING domain 135 

definition of 135 

overlapping of 143 

rules for 142 
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warning message 76 
word 

(see also fullword) 

alignment 166,75 

boundary 166 

length 
wrap-around 

(see also overflow) 

of location counter 42 
WXTRN instruction 152 

external symbol dictionary 
entry for 116 

identifying external symbol 147,152 

opposed to EXTRN instruction 152 

for symbolic linkage 147 



variable symbol 38 

(see also global variable 
symbol, local variable 
symbol) 
as point of substitution 267 
SET symbol 318 
symbolic parameter 260 
system variable symbol 278 
6SYSDATE 279 
6SYSECT 280 
6SYSLIST 281 
SSYSNDX 284 
SSYSPARM 284 
6SYSTIME 287 
V-con (see V-type address 

constant) 
virtual storage 

(see also in GLOSSARY) 
allocation of 
program loaded into 108 
VM/370 

service provided by 9 
V-type address constant 198 
for branching to external 
control section 198,149 
external symbol dictionary 

entry for 116 
identifying external symbol 198 
opposed to EXTRN instruction 149 
for symbolic linkage 147 



X-con (see data constant, 
hexadecimal) 
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Y-con (see address constant, 
Y-type) 



Z-con (see decimal constant, 

zoned) 
zero suppression 

in address values in listing. 

in SETA symbol values 346 
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